@rubytech/create-realagent-code 0.1.594 → 0.1.595

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent-code",
-  "version": "0.1.594",
+  "version": "0.1.595",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent-code": "./dist/index.js"

package/payload/platform/lib/telegram-button-labels/dist/index.d.ts

@@ -0,0 +1,19 @@
+/** Matches CARD_TTL_MS in the telegram MCP's card store. A label outlives its
+ *  card by no useful margin, and without a ceiling every callback data string
+ *  ever sent is kept for ever. */
+export declare const BUTTON_LABEL_TTL_MS: number;
+/** Scoped by bot AND chat, not by the data alone: two chats can use the same
+ *  callback data for different words. */
+export declare function buttonLabelKey(botId: string, chatId: string | number, data: string): string;
+/** Record every button on one keyboard, and drop every entry gone
+ *  BUTTON_LABEL_TTL_MS untouched. Compaction rides the write because the write
+ *  already rewrites the whole file. An empty list writes nothing: a card with no
+ *  buttons must not create the file. */
+export declare function writeButtonLabels(storeDir: string, entries: Array<{
+    key: string;
+    label: string;
+}>, now?: number): void;
+/** The stored wording for this key, or null. Null past the TTL, so a caller
+ *  falls back to the raw data rather than showing a label for a card long gone. */
+export declare function readButtonLabel(storeDir: string, key: string, now?: number): string | null;
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/telegram-button-labels/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA;;kCAEkC;AAClC,eAAO,MAAM,mBAAmB,QAA0B,CAAC;AAa3D;yCACyC;AACzC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F;AAoBD;;;wCAGwC;AACxC,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,GAAG,GAAE,MAAmB,GACvB,IAAI,CASN;AAED;mFACmF;AACnF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAIf"}

package/payload/platform/lib/telegram-button-labels/dist/index.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUTTON_LABEL_TTL_MS = void 0;
+exports.buttonLabelKey = buttonLabelKey;
+exports.writeButtonLabels = writeButtonLabels;
+exports.readButtonLabel = readButtonLabel;
+// Task 2673 — what a button SAID, keyed by what a press CARRIES.
+//
+// A press delivers only its callback data, so an operator reading the
+// conversation sees `[button: pax_1]` and not "1 passenger". The wording exists
+// once, in the keyboard the card tool sent, and was never persisted.
+//
+// This is a shared platform library rather than a key inside the telegram MCP's
+// own card store because the two sides live in different processes: the plugin
+// writes it and the webhook route reads it, and the route imports from
+// platform/lib and never from platform/plugins.
+//
+// Keyed on the callback data rather than the card key: the route holds botId,
+// chatId and data, and never the caller's key.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const FILE = "telegram-button-labels.json";
+/** Matches CARD_TTL_MS in the telegram MCP's card store. A label outlives its
+ *  card by no useful margin, and without a ceiling every callback data string
+ *  ever sent is kept for ever. */
+exports.BUTTON_LABEL_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+function isEntry(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return false;
+    const e = v;
+    return typeof e.label === "string" && typeof e.at === "number" && Number.isFinite(e.at);
+}
+/** Scoped by bot AND chat, not by the data alone: two chats can use the same
+ *  callback data for different words. */
+function buttonLabelKey(botId, chatId, data) {
+    return `${botId}:${chatId}:${data}`;
+}
+function readAll(path) {
+    if (!(0, node_fs_1.existsSync)(path))
+        return {};
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, "utf-8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return {};
+        const out = {};
+        for (const [k, v] of Object.entries(parsed)) {
+            if (isEntry(v))
+                out[k] = v;
+        }
+        return out;
+    }
+    catch {
+        // Unparseable state reads as "no label", which renders the raw data exactly
+        // as it did before this library existed. Throwing here would take a webhook
+        // down over a file no caller sees.
+        return {};
+    }
+}
+/** Record every button on one keyboard, and drop every entry gone
+ *  BUTTON_LABEL_TTL_MS untouched. Compaction rides the write because the write
+ *  already rewrites the whole file. An empty list writes nothing: a card with no
+ *  buttons must not create the file. */
+function writeButtonLabels(storeDir, entries, now = Date.now()) {
+    if (entries.length === 0)
+        return;
+    const path = (0, node_path_1.join)(storeDir, FILE);
+    const kept = {};
+    for (const [key, entry] of Object.entries(readAll(path))) {
+        if (now - entry.at < exports.BUTTON_LABEL_TTL_MS)
+            kept[key] = entry;
+    }
+    for (const e of entries)
+        kept[e.key] = { label: e.label, at: now };
+    (0, node_fs_1.writeFileSync)(path, JSON.stringify(kept, null, 2) + "\n", "utf-8");
+}
+/** The stored wording for this key, or null. Null past the TTL, so a caller
+ *  falls back to the raw data rather than showing a label for a card long gone. */
+function readButtonLabel(storeDir, key, now = Date.now()) {
+    const entry = readAll((0, node_path_1.join)(storeDir, FILE))[key];
+    if (!entry)
+        return null;
+    return now - entry.at >= exports.BUTTON_LABEL_TTL_MS ? null : entry.label;
+}
+//# sourceMappingURL=index.js.map

package/payload/platform/lib/telegram-button-labels/dist/index.js.map

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

package/payload/platform/lib/telegram-button-labels/src/__tests__/store.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it, beforeEach, afterEach } from 'vitest'
+import { mkdtempSync, rmSync, existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+import {
+  BUTTON_LABEL_TTL_MS,
+  buttonLabelKey,
+  readButtonLabel,
+  writeButtonLabels,
+} from '../index.js'
+
+let dir: string
+
+beforeEach(() => {
+  dir = mkdtempSync(join(tmpdir(), 'tg-labels-'))
+})
+
+afterEach(() => {
+  rmSync(dir, { recursive: true, force: true })
+})
+
+describe('button label store', () => {
+  it('keys on bot, chat and callback data, which is all a press carries', () => {
+    expect(buttonLabelKey('111', 999, 'pax_1')).toBe('111:999:pax_1')
+    expect(buttonLabelKey('111', '999', 'pax_1')).toBe('111:999:pax_1')
+  })
+
+  it('reads back a label written for that key', () => {
+    writeButtonLabels(dir, [{ key: buttonLabelKey('111', 999, 'pax_1'), label: '1 passenger' }])
+    expect(readButtonLabel(dir, buttonLabelKey('111', 999, 'pax_1'))).toBe('1 passenger')
+  })
+
+  it('returns null for a key never written', () => {
+    expect(readButtonLabel(dir, buttonLabelKey('111', 999, 'nope'))).toBeNull()
+  })
+
+  it('returns null past the ttl, and prunes it on the next write', () => {
+    const t0 = 1_000_000
+    const k = buttonLabelKey('111', 999, 'pax_1')
+    writeButtonLabels(dir, [{ key: k, label: '1 passenger' }], t0)
+    expect(readButtonLabel(dir, k, t0 + BUTTON_LABEL_TTL_MS)).toBeNull()
+    writeButtonLabels(dir, [{ key: buttonLabelKey('111', 999, 'pax_2'), label: '2 passengers' }], t0 + BUTTON_LABEL_TTL_MS)
+    const onDisk = JSON.parse(readFileSync(join(dir, 'telegram-button-labels.json'), 'utf-8')) as Record<string, unknown>
+    expect(Object.keys(onDisk)).toEqual(['111:999:pax_2'])
+  })
+
+  it('a later write for the same key replaces the label and refreshes its age', () => {
+    const t0 = 1_000_000
+    const k = buttonLabelKey('111', 999, 'pax_1')
+    writeButtonLabels(dir, [{ key: k, label: 'one' }], t0)
+    writeButtonLabels(dir, [{ key: k, label: 'ONE' }], t0 + 1)
+    expect(readButtonLabel(dir, k, t0 + 2)).toBe('ONE')
+  })
+
+  it('an unparseable file reads as no label and never throws', () => {
+    const path = join(dir, 'telegram-button-labels.json')
+    writeButtonLabels(dir, [{ key: 'a', label: 'b' }])
+    rmSync(path)
+    expect(readButtonLabel(dir, 'a')).toBeNull()
+    expect(existsSync(path)).toBe(false)
+  })
+
+  it('an empty entry list writes nothing, so a card with no buttons touches no file', () => {
+    writeButtonLabels(dir, [])
+    expect(existsSync(join(dir, 'telegram-button-labels.json'))).toBe(false)
+  })
+})

package/payload/platform/lib/telegram-button-labels/src/index.ts

@@ -0,0 +1,88 @@
+// Task 2673 — what a button SAID, keyed by what a press CARRIES.
+//
+// A press delivers only its callback data, so an operator reading the
+// conversation sees `[button: pax_1]` and not "1 passenger". The wording exists
+// once, in the keyboard the card tool sent, and was never persisted.
+//
+// This is a shared platform library rather than a key inside the telegram MCP's
+// own card store because the two sides live in different processes: the plugin
+// writes it and the webhook route reads it, and the route imports from
+// platform/lib and never from platform/plugins.
+//
+// Keyed on the callback data rather than the card key: the route holds botId,
+// chatId and data, and never the caller's key.
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const FILE = "telegram-button-labels.json";
+
+/** Matches CARD_TTL_MS in the telegram MCP's card store. A label outlives its
+ *  card by no useful margin, and without a ceiling every callback data string
+ *  ever sent is kept for ever. */
+export const BUTTON_LABEL_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+
+interface LabelEntry {
+  label: string;
+  at: number;
+}
+
+function isEntry(v: unknown): v is LabelEntry {
+  if (!v || typeof v !== "object" || Array.isArray(v)) return false;
+  const e = v as Record<string, unknown>;
+  return typeof e.label === "string" && typeof e.at === "number" && Number.isFinite(e.at);
+}
+
+/** Scoped by bot AND chat, not by the data alone: two chats can use the same
+ *  callback data for different words. */
+export function buttonLabelKey(botId: string, chatId: string | number, data: string): string {
+  return `${botId}:${chatId}:${data}`;
+}
+
+function readAll(path: string): Record<string, LabelEntry> {
+  if (!existsSync(path)) return {};
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf-8")) as unknown;
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    const out: Record<string, LabelEntry> = {};
+    for (const [k, v] of Object.entries(parsed as Record<string, unknown>)) {
+      if (isEntry(v)) out[k] = v;
+    }
+    return out;
+  } catch {
+    // Unparseable state reads as "no label", which renders the raw data exactly
+    // as it did before this library existed. Throwing here would take a webhook
+    // down over a file no caller sees.
+    return {};
+  }
+}
+
+/** Record every button on one keyboard, and drop every entry gone
+ *  BUTTON_LABEL_TTL_MS untouched. Compaction rides the write because the write
+ *  already rewrites the whole file. An empty list writes nothing: a card with no
+ *  buttons must not create the file. */
+export function writeButtonLabels(
+  storeDir: string,
+  entries: Array<{ key: string; label: string }>,
+  now: number = Date.now(),
+): void {
+  if (entries.length === 0) return;
+  const path = join(storeDir, FILE);
+  const kept: Record<string, LabelEntry> = {};
+  for (const [key, entry] of Object.entries(readAll(path))) {
+    if (now - entry.at < BUTTON_LABEL_TTL_MS) kept[key] = entry;
+  }
+  for (const e of entries) kept[e.key] = { label: e.label, at: now };
+  writeFileSync(path, JSON.stringify(kept, null, 2) + "\n", "utf-8");
+}
+
+/** The stored wording for this key, or null. Null past the TTL, so a caller
+ *  falls back to the raw data rather than showing a label for a card long gone. */
+export function readButtonLabel(
+  storeDir: string,
+  key: string,
+  now: number = Date.now(),
+): string | null {
+  const entry = readAll(join(storeDir, FILE))[key];
+  if (!entry) return null;
+  return now - entry.at >= BUTTON_LABEL_TTL_MS ? null : entry.label;
+}

package/payload/platform/lib/telegram-button-labels/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["src/__tests__"]
+}

package/payload/platform/lib/telegram-button-labels/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: false,
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

package/payload/platform/package.json

@@ -10,8 +10,8 @@
     "pdf-lib": "^1.17.1"
   },
   "scripts": {
-    "build": "tsc -p lib/account-schema-regions/tsconfig.json && tsc -p lib/account-ingest-token/tsconfig.json && tsc -p lib/models/tsconfig.json && tsc -p lib/agent-slug/tsconfig.json && tsc -p lib/mcp-spawn-tee/tsconfig.json && tsc -p lib/mcp-lifeline/tsconfig.json && tsc -p lib/mcp-eager/tsconfig.json && tsc -p lib/account-enumeration/tsconfig.json && tsc -p lib/account-scope/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/graph-write/tsconfig.json && tsc -p lib/ledger-core/tsconfig.json && tsc -p lib/embed-client/tsconfig.json && tsc -p lib/graph-mcp/tsconfig.json && tsc -p lib/graph-trash/tsconfig.json && tsc -p lib/active-rules/tsconfig.json && tsc -p lib/admin-conversation-purge/tsconfig.json && tsc -p lib/graph-search/tsconfig.json && tsc -p lib/graph-style/tsconfig.json && tsc -p lib/device-url/tsconfig.json && tsc -p lib/brand-templating/tsconfig.json && tsc -p lib/entitlement/tsconfig.json && tsc -p lib/task-secrets/tsconfig.json && tsc -p lib/admins-write/tsconfig.json && tsc -p lib/admin-access-password/tsconfig.json && tsc -p lib/persistent-components/tsconfig.json && tsc -p lib/require-port-env/tsconfig.json && tsc -p lib/aeo-llms-txt-writer/tsconfig.json && tsc -p lib/obsidian-parser/tsconfig.json && tsc -p lib/storage-broker/tsconfig.json && tsc -p lib/routine-templates/tsconfig.json && tsc -p lib/agent-dispatch-rule/tsconfig.json && tsc -p lib/canonical-instant/tsconfig.json && tsc -p lib/dispatch-read/tsconfig.json && tsc -p lib/dispatch-write/tsconfig.json && tsc -p lib/learning-constants/tsconfig.json && tsc -p lib/telegram-media/tsconfig.json && tsc -p lib/telegram-managed-bot/tsconfig.json && tsc -p lib/telegram-reach/tsconfig.json && tsc -p services/claude-session-manager/tsconfig.json && tsc -p services/whatsapp-channel/tsconfig.json && tsc -p services/webchat-channel/tsconfig.json && tsc -p services/telegram-channel/tsconfig.json && NODE_OPTIONS='--max-old-space-size=8192' tsc -b plugins/*/mcp/tsconfig.json",
-    "build:lib": "tsc -p lib/account-schema-regions/tsconfig.json && tsc -p lib/account-ingest-token/tsconfig.json && tsc -p lib/models/tsconfig.json && tsc -p lib/agent-slug/tsconfig.json && tsc -p lib/mcp-spawn-tee/tsconfig.json && tsc -p lib/mcp-lifeline/tsconfig.json && tsc -p lib/mcp-eager/tsconfig.json && tsc -p lib/account-enumeration/tsconfig.json && tsc -p lib/account-scope/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/graph-write/tsconfig.json && tsc -p lib/ledger-core/tsconfig.json && tsc -p lib/embed-client/tsconfig.json && tsc -p lib/graph-mcp/tsconfig.json && tsc -p lib/graph-trash/tsconfig.json && tsc -p lib/active-rules/tsconfig.json && tsc -p lib/admin-conversation-purge/tsconfig.json && tsc -p lib/graph-search/tsconfig.json && tsc -p lib/graph-style/tsconfig.json && tsc -p lib/device-url/tsconfig.json && tsc -p lib/brand-templating/tsconfig.json && tsc -p lib/entitlement/tsconfig.json && tsc -p lib/task-secrets/tsconfig.json && tsc -p lib/admins-write/tsconfig.json && tsc -p lib/admin-access-password/tsconfig.json && tsc -p lib/persistent-components/tsconfig.json && tsc -p lib/require-port-env/tsconfig.json && tsc -p lib/aeo-llms-txt-writer/tsconfig.json && tsc -p lib/obsidian-parser/tsconfig.json && tsc -p lib/storage-broker/tsconfig.json && tsc -p lib/routine-templates/tsconfig.json && tsc -p lib/agent-dispatch-rule/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/canonical-instant/tsconfig.json && tsc -p lib/dispatch-read/tsconfig.json && tsc -p lib/dispatch-write/tsconfig.json && tsc -p lib/telegram-media/tsconfig.json && tsc -p lib/telegram-managed-bot/tsconfig.json && tsc -p lib/telegram-reach/tsconfig.json",
+    "build": "tsc -p lib/account-schema-regions/tsconfig.json && tsc -p lib/account-ingest-token/tsconfig.json && tsc -p lib/models/tsconfig.json && tsc -p lib/agent-slug/tsconfig.json && tsc -p lib/mcp-spawn-tee/tsconfig.json && tsc -p lib/mcp-lifeline/tsconfig.json && tsc -p lib/mcp-eager/tsconfig.json && tsc -p lib/account-enumeration/tsconfig.json && tsc -p lib/account-scope/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/graph-write/tsconfig.json && tsc -p lib/ledger-core/tsconfig.json && tsc -p lib/embed-client/tsconfig.json && tsc -p lib/graph-mcp/tsconfig.json && tsc -p lib/graph-trash/tsconfig.json && tsc -p lib/active-rules/tsconfig.json && tsc -p lib/admin-conversation-purge/tsconfig.json && tsc -p lib/graph-search/tsconfig.json && tsc -p lib/graph-style/tsconfig.json && tsc -p lib/device-url/tsconfig.json && tsc -p lib/brand-templating/tsconfig.json && tsc -p lib/entitlement/tsconfig.json && tsc -p lib/task-secrets/tsconfig.json && tsc -p lib/admins-write/tsconfig.json && tsc -p lib/admin-access-password/tsconfig.json && tsc -p lib/persistent-components/tsconfig.json && tsc -p lib/require-port-env/tsconfig.json && tsc -p lib/aeo-llms-txt-writer/tsconfig.json && tsc -p lib/obsidian-parser/tsconfig.json && tsc -p lib/storage-broker/tsconfig.json && tsc -p lib/routine-templates/tsconfig.json && tsc -p lib/agent-dispatch-rule/tsconfig.json && tsc -p lib/canonical-instant/tsconfig.json && tsc -p lib/dispatch-read/tsconfig.json && tsc -p lib/dispatch-write/tsconfig.json && tsc -p lib/learning-constants/tsconfig.json && tsc -p lib/telegram-button-labels/tsconfig.json && tsc -p lib/telegram-media/tsconfig.json && tsc -p lib/telegram-managed-bot/tsconfig.json && tsc -p lib/telegram-reach/tsconfig.json && tsc -p services/claude-session-manager/tsconfig.json && tsc -p services/whatsapp-channel/tsconfig.json && tsc -p services/webchat-channel/tsconfig.json && tsc -p services/telegram-channel/tsconfig.json && NODE_OPTIONS='--max-old-space-size=8192' tsc -b plugins/*/mcp/tsconfig.json",
+    "build:lib": "tsc -p lib/account-schema-regions/tsconfig.json && tsc -p lib/account-ingest-token/tsconfig.json && tsc -p lib/models/tsconfig.json && tsc -p lib/agent-slug/tsconfig.json && tsc -p lib/mcp-spawn-tee/tsconfig.json && tsc -p lib/mcp-lifeline/tsconfig.json && tsc -p lib/mcp-eager/tsconfig.json && tsc -p lib/account-enumeration/tsconfig.json && tsc -p lib/account-scope/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/graph-write/tsconfig.json && tsc -p lib/ledger-core/tsconfig.json && tsc -p lib/embed-client/tsconfig.json && tsc -p lib/graph-mcp/tsconfig.json && tsc -p lib/graph-trash/tsconfig.json && tsc -p lib/active-rules/tsconfig.json && tsc -p lib/admin-conversation-purge/tsconfig.json && tsc -p lib/graph-search/tsconfig.json && tsc -p lib/graph-style/tsconfig.json && tsc -p lib/device-url/tsconfig.json && tsc -p lib/brand-templating/tsconfig.json && tsc -p lib/entitlement/tsconfig.json && tsc -p lib/task-secrets/tsconfig.json && tsc -p lib/admins-write/tsconfig.json && tsc -p lib/admin-access-password/tsconfig.json && tsc -p lib/persistent-components/tsconfig.json && tsc -p lib/require-port-env/tsconfig.json && tsc -p lib/aeo-llms-txt-writer/tsconfig.json && tsc -p lib/obsidian-parser/tsconfig.json && tsc -p lib/storage-broker/tsconfig.json && tsc -p lib/routine-templates/tsconfig.json && tsc -p lib/agent-dispatch-rule/tsconfig.json && tsc -p lib/shared-folder/tsconfig.json && tsc -p lib/canonical-instant/tsconfig.json && tsc -p lib/dispatch-read/tsconfig.json && tsc -p lib/dispatch-write/tsconfig.json && tsc -p lib/telegram-button-labels/tsconfig.json && tsc -p lib/telegram-media/tsconfig.json && tsc -p lib/telegram-managed-bot/tsconfig.json && tsc -p lib/telegram-reach/tsconfig.json",
     "clean:dist": "node scripts/check-orphan-dist.mjs --remove",
     "gen:canonical-tools": "node scripts/generate-canonical-tool-names.mjs",
     "build:memory": "tsc -p plugins/memory/mcp/tsconfig.json",

package/payload/platform/plugins/admin/skills/platform-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: platform-architecture
 description: Use when grounding any documented-surface claim about what Real Agent ships — plugins, skills, specialists, install/deploy flows, internals. This is the install catalogue, not evidence of what is enabled on the current account. For install state on this account, call `capabilities-here`; for documented surface, cite the `Source:` URL inline.
-content-hash: sha256:ea35aa77226e01aad93c7b90e9118e4e993a58cb980330b28541dcbb3122a993
+content-hash: sha256:4d7fafd7d648ca6953247a413d12dd0be25fd9e0c6876f1afb5ece48b1c0acdc
 brand: realagent-code
 product-name: Real Agent
 ---
@@ -3012,6 +3012,13 @@ nobody, and a vote was dropped without a trace. A press on a job-sheet card is t
 one exception: the dispatch plugin applies the change and tells the presser
 itself, so Real Agent does not answer a second time.
 
+A card carries its own words, so when Real Agent sends a card with buttons
+it puts the answer in the card itself and does not add a sentence beside it. On a
+public bot, that following sentence is held back on purpose, so the visitor sees
+the card once and not the same thing twice. And when someone presses a button,
+your conversation view shows the button's own wording — "1 passenger", "One way"
+— rather than the code behind it.
+
 The same is now true of most of what Telegram sends. Reply to one of
 Real Agent's messages and it sees the message you replied to, so "yes, do
 that one" means something. React to a message with an emoji and it hears the

package/payload/platform/plugins/admin/skills/whats-new/SKILL.md

@@ -9,6 +9,11 @@ Invoked by the admin agent directly.
 
 This is the platform's release timeline, newest first. Each entry shows the date it shipped and the version it shipped in, so you can tell the operator how current their install is. To compare, read the installed version from `capabilities-here` and match it against the versions below. Keep answers high level and in plain English; this is a summary, not a full commit log.
 
+## 2026-08-11 (0.1.595)
+
+- A Telegram bot no longer describes the card it just sent you. The card arrived and the bot then narrated it in a second message, because the rule that withholds that text never took effect.
+- Pressing a button now reads as the button's own label rather than the code behind it. A standing check reports if card text stops being withheld again.
+
 ## 2026-08-11 (0.1.594)
 
 - A public Telegram bot no longer tells people it cannot do things it can. Its own description denied the tools it had actually been given, so it refused work it was equipped for.

package/payload/platform/plugins/docs/references/telegram-guide.md

@@ -189,6 +189,13 @@ nobody, and a vote was dropped without a trace. A press on a job-sheet card is t
 one exception: the dispatch plugin applies the change and tells the presser
 itself, so {{productName}} does not answer a second time.
 
+A card carries its own words, so when {{productName}} sends a card with buttons
+it puts the answer in the card itself and does not add a sentence beside it. On a
+public bot, that following sentence is held back on purpose, so the visitor sees
+the card once and not the same thing twice. And when someone presses a button,
+your conversation view shows the button's own wording — "1 passenger", "One way"
+— rather than the code behind it.
+
 The same is now true of most of what Telegram sends. Reply to one of
 {{productName}}'s messages and it sees the message you replied to, so "yes, do
 that one" means something. React to a message with an emoji and it hears the