@www.hyperlinks.space/program-kit 18.18.18 → 123.123.123

package/ai/transmitter.ts

@@ -0,0 +1,367 @@
+import type { AiMode, AiRequestBase, AiResponseBase, ThreadContext } from "./openai.js";
+import { callOpenAiChat, callOpenAiChatStream } from "./openai.js";
+import {
+  getTokenBySymbol,
+  normalizeSymbol,
+  type TokenSearchResult,
+} from "../blockchain/coffee.js";
+import {
+  insertMessage,
+  getThreadHistory,
+  type Message,
+} from "../database/messages.js";
+
+export type AiRequest = AiRequestBase & {
+  mode?: AiMode;
+};
+
+export type AiResponse = AiResponseBase;
+
+const HISTORY_LIMIT = 50;
+
+function formatHistoryForInput(history: Message[]): string {
+  if (history.length === 0) return "";
+  const lines = history.map((m) => {
+    const role = m.role === "user" ? "user" : m.role === "assistant" ? "assistant" : "system";
+    const content = (m.content ?? "").trim();
+    return `${role}: ${content}`;
+  });
+  return "Previous conversation:\n" + lines.join("\n") + "\n\n";
+}
+
+/** Claim by insert; return skipped response if another instance won. */
+async function claimUserMessage(
+  thread: ThreadContext,
+  content: string,
+): Promise<AiResponse | null> {
+  const inserted = await insertMessage({
+    user_telegram: thread.user_telegram,
+    thread_id: thread.thread_id,
+    type: thread.type,
+    role: "user",
+    content,
+    telegram_update_id: thread.telegram_update_id ?? undefined,
+  });
+  if (inserted === null) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode: "chat",
+      skipped: true,
+    };
+  }
+  return null;
+}
+
+async function persistAssistantMessage(
+  thread: ThreadContext,
+  content: string,
+): Promise<void> {
+  await insertMessage({
+    user_telegram: thread.user_telegram,
+    thread_id: thread.thread_id,
+    type: thread.type,
+    role: "assistant",
+    content,
+  });
+}
+
+function extractSymbolCandidate(input: string): string | null {
+  const raw = input.trim();
+  if (!raw) return null;
+
+  // Simple patterns like "USDT", "$USDT", "USDT on TON".
+  const parts = raw.split(/\s+/);
+  const first = parts[0]?.replace(/^\$/g, "") ?? "";
+  const normalized = normalizeSymbol(first);
+  return normalized || null;
+}
+
+function buildTokenFactsBlock(symbol: string, token: any): string {
+  const lines: string[] = [];
+
+  const sym = token?.symbol ?? symbol;
+  const name = token?.name ?? null;
+  const address = token?.id ?? token?.address ?? null;
+  const type = token?.type ?? "token";
+  const decimals = token?.decimals ?? token?.metadata?.decimals ?? null;
+  const verification =
+    token?.verification ?? token?.metadata?.verification ?? null;
+
+  const market = token?.market_stats ?? {};
+  const holders =
+    market?.holders_count ?? token?.holders ?? market?.holders ?? null;
+  const priceUsd = market?.price_usd ?? null;
+  const mcap = market?.mcap ?? market?.fdmc ?? null;
+  const volume24h = market?.volume_usd_24h ?? null;
+
+  lines.push(`Symbol: ${sym}`);
+  if (name) {
+    lines.push(`Name: ${name}`);
+  }
+  lines.push(`Type: ${type}`);
+  lines.push(`Blockchain: TON`);
+  if (address) {
+    lines.push(`Address: ${address}`);
+  }
+  if (decimals != null) {
+    lines.push(`Decimals: ${decimals}`);
+  }
+  if (verification) {
+    lines.push(`Verification: ${verification}`);
+  }
+  if (holders != null) {
+    lines.push(`Holders: ${holders}`);
+  }
+  if (priceUsd != null) {
+    lines.push(`Price (USD): ${priceUsd}`);
+  }
+  if (mcap != null) {
+    lines.push(`Market cap (USD): ${mcap}`);
+  }
+  if (volume24h != null) {
+    lines.push(`24h volume (USD): ${volume24h}`);
+  }
+
+  return lines.join("\n");
+}
+
+async function handleTokenInfo(
+  request: AiRequest,
+): Promise<AiResponse> {
+  const trimmed = request.input?.trim() ?? "";
+  const symbolCandidate = extractSymbolCandidate(trimmed);
+
+  if (!symbolCandidate) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode: "token_info",
+      error: "Could not detect a token symbol. Try sending something like USDT.",
+    };
+  }
+
+  const tokenResult: TokenSearchResult = await getTokenBySymbol(
+    symbolCandidate,
+  );
+
+  if (!tokenResult.ok) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode: "token_info",
+      error:
+        tokenResult.error === "not_found"
+          ? `Token ${symbolCandidate} was not found on TON.`
+          : "Token service is temporarily unavailable.",
+      meta: {
+        symbol: symbolCandidate,
+        reason: tokenResult.reason,
+        status_code: tokenResult.status_code,
+      },
+    };
+  }
+
+  const token = tokenResult.data;
+  const facts = buildTokenFactsBlock(symbolCandidate, token);
+
+  const promptParts = [
+    "You are a concise TON token analyst.",
+    "",
+    "Facts about the token:",
+    facts,
+    "",
+    "User question or context:",
+    trimmed,
+  ];
+
+  const composedInput = promptParts.join("\n");
+
+  const result = await callOpenAiChat("token_info", {
+    input: composedInput,
+    userId: request.userId,
+    context: {
+      ...request.context,
+      symbol: symbolCandidate,
+      token,
+      source: "swap.coffee",
+    },
+    instructions: request.instructions,
+  });
+
+  return {
+    ...result,
+    mode: "token_info",
+    meta: {
+      ...(result.meta ?? {}),
+      symbol: symbolCandidate,
+      token,
+    },
+  };
+}
+
+export async function transmit(request: AiRequest): Promise<AiResponse> {
+  const mode: AiMode = request.mode ?? "chat";
+  const thread = request.threadContext;
+
+  if (thread && !thread.skipClaim) {
+    const skipped = await claimUserMessage(thread, request.input);
+    if (skipped) return skipped;
+  }
+
+  if (mode === "token_info") {
+    const result = await handleTokenInfo(request);
+    if (result.ok && result.output_text && thread) {
+      await persistAssistantMessage(thread, result.output_text);
+    }
+    return result;
+  }
+
+  let input = request.input;
+  if (thread) {
+    const history = await getThreadHistory({
+      user_telegram: thread.user_telegram,
+      thread_id: thread.thread_id,
+      type: thread.type,
+      limit: HISTORY_LIMIT,
+    });
+    input = formatHistoryForInput(history) + "Current message:\nuser: " + request.input;
+  }
+
+  const result = await callOpenAiChat(mode, {
+    input,
+    userId: request.userId,
+    context: request.context,
+    instructions: request.instructions,
+  });
+
+  if (result.ok && result.output_text && thread) {
+    await persistAssistantMessage(thread, result.output_text);
+  }
+  return result;
+}
+
+/** Stream AI response; onDelta(accumulatedText) is called for each chunk. Only the final OpenAI call is streamed. */
+export async function transmitStream(
+  request: AiRequest,
+  onDelta: (text: string) => void | Promise<void>,
+  opts?: { isCancelled?: () => boolean; getAbortSignal?: () => Promise<boolean> },
+): Promise<AiResponse> {
+  const mode: AiMode = request.mode ?? "chat";
+  const thread = request.threadContext;
+
+  if (thread && !thread.skipClaim) {
+    const skipped = await claimUserMessage(thread, request.input);
+    if (skipped) return skipped;
+  }
+
+  if (mode === "token_info") {
+    const tokenResult = await (async () => {
+      const trimmed = request.input?.trim() ?? "";
+      const symbolCandidate = extractSymbolCandidate(trimmed);
+      if (!symbolCandidate) {
+        return null;
+      }
+      return getTokenBySymbol(symbolCandidate);
+    })();
+
+    if (!tokenResult) {
+      return {
+        ok: false,
+        provider: "openai",
+        mode: "token_info",
+        error: "Could not detect a token symbol. Try sending something like USDT.",
+      };
+    }
+    if (!tokenResult.ok) {
+      const symbolCandidate = extractSymbolCandidate(request.input?.trim() ?? "");
+      return {
+        ok: false,
+        provider: "openai",
+        mode: "token_info",
+        error:
+          tokenResult.error === "not_found"
+            ? `Token ${symbolCandidate ?? ""} was not found on TON.`
+            : "Token service is temporarily unavailable.",
+        meta: {
+          symbol: tokenResult.symbol,
+          reason: tokenResult.reason,
+          status_code: tokenResult.status_code,
+        },
+      };
+    }
+
+    const token = tokenResult.data;
+    const symbolCandidate = extractSymbolCandidate(request.input?.trim() ?? "")!;
+    const facts = buildTokenFactsBlock(symbolCandidate, token);
+    const trimmed = request.input?.trim() ?? "";
+    const promptParts = [
+      "You are a concise TON token analyst.",
+      "",
+      "Facts about the token:",
+      facts,
+      "",
+      "User question or context:",
+      trimmed,
+    ];
+    const composedInput = promptParts.join("\n");
+
+    const result = await callOpenAiChatStream(
+      "token_info",
+      {
+        input: composedInput,
+        userId: request.userId,
+        context: {
+          ...request.context,
+          symbol: symbolCandidate,
+          token,
+          source: "swap.coffee",
+        },
+        instructions: request.instructions,
+      },
+      onDelta,
+      opts,
+    );
+
+    if (result.ok && result.output_text && thread) {
+      await persistAssistantMessage(thread, result.output_text);
+    }
+    return {
+      ...result,
+      mode: "token_info",
+      meta: {
+        ...(result.meta ?? {}),
+        symbol: symbolCandidate,
+        token,
+      },
+    };
+  }
+
+  let input = request.input;
+  if (thread) {
+    const history = await getThreadHistory({
+      user_telegram: thread.user_telegram,
+      thread_id: thread.thread_id,
+      type: thread.type,
+      limit: HISTORY_LIMIT,
+    });
+    input = formatHistoryForInput(history) + "Current message:\nuser: " + request.input;
+  }
+
+  const result = await callOpenAiChatStream(
+    mode,
+    {
+      input,
+      userId: request.userId,
+      context: request.context,
+      instructions: request.instructions,
+    },
+    onDelta,
+    opts,
+  );
+
+  if (result.ok && result.output_text && thread) {
+    await persistAssistantMessage(thread, result.output_text);
+  }
+  return result;
+}

package/backlogs/medium_term_backlog.md

@@ -0,0 +1,26 @@
+header indent bag in fullsize<br>
+rotation on swap page<br>
+edit interval healthcheck<br>
+Ticker link<br>
+Scrolling in AI widget fix<br>
+Finish bot parts isolation<br>
+ld timeout<br>
+AI bd<br>
+Hovers<br>
+Languages<br>
+Favicon change<br>
+Wallet creation and nickname generation<br>
+Jetton lockup<br>
+Theme in Chrome<br>
+Bd<br>
+Wallet creation<br>
+Apps design<br>
+Plan users bd for search<br>
+Brand book<br>
+Fix<br>
+Starting Rewards<br>
+Feed items types<br>
+PAY BY QR<br>
+swap long rate state<br>
+swaps<br>
+tokns<br>

package/backlogs/short_term_backlog.md

@@ -0,0 +1,42 @@
+Polyfils refactoring<br>
+Wallet: Telegram, Connected, Unhosted<br>
+Username loaded without intermediate state<br>
+Bottom bar refactor<br>
+AI options page<br>
+Bottom bar icon review<br>
+AI chat page<br>
+Bring repository root app to demo design state<br>
+GitHub and GitLab bidirectional mirroring<br>
+readme.md<br>
+Windows setup refactor<br>
+https://azure.microsoft.com/en-us/products/artifact-signing<br>
+README.md: Project news, discussions, where to learn for contributions<br>
+
+Issues:<br>
+Several chats async streaming<br>
+
+Pull requests:<br>
+AI responce checkup in bot (message interruption on new prompt)<br>
+Typing in the middle of the text on large inputting<br>
+
+To think about:<br>
+Branding and naming
+Place of the install update dialog in the UI<br>
+Updater: fasten instant reload<br>
+Custom installer design<br>
+Fluent installer progress bar<br>
+Optional cleanup of legacy Forge v5 deps<br>
+Workflows dry mode (build check without releasing)<br>
+Move Telegram folder contents to API<br>
+https://www.npmjs.com/package/electron-log<br>
+PGP release signing<br>
+File's formats and folders structure<br>
+Selection and pointing text detalization<br>
+    on word tapping places at the end of the word<br>
+    zoom-in cursor placing on long tap<br>
+Instructions.ts in AI<br>
+
+Abandoned:<br>
+Placeholder refactor<br>
+Logo bar visibility<br>
+Overlay on screen expansion from mobile<br>

package/eslint.config.cjs

@@ -0,0 +1,10 @@
+// https://docs.expo.dev/guides/using-eslint/
+const { defineConfig } = require('eslint/config');
+const expoConfig = require('eslint-config-expo/flat');
+
+module.exports = defineConfig([
+  expoConfig,
+  {
+    ignores: ['dist/*'],
+  },
+]);

package/npmReadMe.md

@@ -33,12 +33,17 @@ registry and token.
 
 ## After Scaffold
 
+Copy `npmrc.example` to `.npmrc` so installs match this repo (`legacy-peer-deps`; npm does not ship a real `.npmrc` in the tarball for security):
+
 ```bash
 cd new-program
+cp npmrc.example .npmrc
 npm install
 npm run start
 ```
 
+If you prefer not to use a `.npmrc`, you can run **`npm install --legacy-peer-deps`** instead of the copy step.
+
 Then open the project **`fullREADME.md`** for details (env vars, bot setup, build
 and release commands).
 
@@ -49,5 +54,15 @@ and release commands).
 
 ## Notes
 
-- Published directly from the `app/` folder.
-- Package tarball is filtered to include only required project files.
+- Published from the repository root; the pack includes everything except patterns in [`.npmignore`](./.npmignore) (no `files` whitelist in `package.json`).
+- `.npmrc` cannot be published on npm; `npmrc.example` is included so you can copy it locally.
+
+## Matching local development
+
+Use the same setup you would after cloning this repo:
+
+1. **Node** — Prefer the version in [`.nvmrc`](./.nvmrc) (aligned with [`package.json`](./package.json) `engines`).
+2. **npm install** — Copy [`npmrc.example`](./npmrc.example) to `.npmrc`, then run `npm install` (same `legacy-peer-deps` behavior as a local checkout with a root `.npmrc`).
+3. **Env** — Copy [`.env.example`](./.env.example) to `.env` and fill variables (details in **`fullREADME.md`** after the CI readme swap, or in the main repo README).
+
+The tarball does not ship `package-lock.json` (by [`.npmignore`](./.npmignore)); the first install generates a lockfile for your machine, like cloning without a committed lock.

package/npmrc.example

@@ -0,0 +1 @@
+legacy-peer-deps=true

package/package.json

@@ -2,46 +2,21 @@
   "name": "@www.hyperlinks.space/program-kit",
   "productName": "Hyperlinks Space Program",
   "description": "Hyperlinks Space Program",
-  "author": "sraibaby",
+  "author": "https://www.hyperlinks.space",
   "license": "0BSD",
   "private": false,
   "bin": {
     "program-kit": "scripts/program-kit-init.cjs"
   },
-  "files": [
-    ".env.example",
-    "README.md",
-    "fullREADME.md",
-    "npmReadMe.md",
-    "app",
-    "api",
-    "app.json",
-    "assets",
-    "blockchain",
-    "bot",
-    "database",
-    "docs",
-    "!docs/debug.log",
-    "!docs/issue.md",
-    "eas.json",
-    "eslint.config.js",
-    "global.css",
-    "package-lock.json",
-    "scripts",
-    "telegram",
-    "tsconfig.json",
-    "vercel.json",
-    "windows"
-  ],
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/HyperlinksSpace/HyperlinksSpaceBot.git"
+    "url": "https://github.com/HyperlinksSpace/HyperlinksSpaceProgram.git"
   },
   "main": "index.js",
-  "version": "18.18.18",
+  "version": "123.123.123",
   "type": "module",
   "engines": {
     "node": ">=18 <=22"

package/polyfills/buffer.ts

@@ -0,0 +1,9 @@
+/**
+ * Load before any module that touches Node's `Buffer` at evaluation time (e.g. @ton/*).
+ * Browsers and Telegram WebView do not define `globalThis.Buffer`.
+ */
+import { Buffer } from "buffer";
+
+if (typeof globalThis !== "undefined" && !(globalThis as { Buffer?: unknown }).Buffer) {
+  (globalThis as { Buffer: typeof Buffer }).Buffer = Buffer;
+}

package/research & docs/ai_and_search_bar_input.md

@@ -0,0 +1,94 @@
+## AI & Search bar input behaviour
+
+This document describes how the text in the global AI & Search bottom bar should behave as the user types, matching the Flutter implementation.
+
+---
+
+### 1. Reference states (pictures sequence)
+
+The reference images show a sequence of states for a long line of text; they illustrate how the bar grows and then turns into a scrolling window:
+
+1. **Full text, no bar**  
+   Long multi‑line text fills a tall content area. This is effectively the raw content without the constraints of the bottom bar.
+
+2. **Initial bar: single line + arrow**  
+   - Only a single line of text is visible.  
+   - The text baseline is horizontally aligned with the apply arrow icon on the right.  
+   - There is empty space above the line; bar height is at its minimum.
+
+3. **Unconstrained multi‑line text**  
+   - Text has grown to multiple lines in a taller, unbounded view (again, this is the raw content).  
+
+4. **Growing bar: multiple lines + arrow**  
+   - The bottom bar has increased in height to show multiple lines.  
+   - As lines are added, the **space above the text shrinks**, but the **last visible line remains on the same vertical level as the arrow**.  
+   - Visually, the bar grows upwards while the arrow + last line baseline stays fixed.
+
+5. **Very long text, no bar**  
+   - The entire long text block is visible in a tall area, showing how much total content exists.
+
+6. **Capped bar height: scrolling window**  
+   - The bottom bar height is now capped (e.g. at 180 px).  
+   - The visible area becomes a **fixed‑height window** into the text:
+     - Older lines at the top continue moving up and eventually disappear under the **top edge** of the bar as more text is entered.
+     - The **last visible line stays aligned with the arrow baseline** at the bottom of the bar. The typing position does not move vertically once the bar has reached its maximum height.
+
+---
+
+### 2. Detailed behaviour by line count
+
+#### 1–7 lines: growing bar
+
+- For each new line from 1 up to 7:
+  - The **bottom bar height increases** by exactly one line height (20 px).  
+  - The height formula is:
+    \[
+    \text{height} = 20\text{ (top padding)} + N \times 20\text{ (lines)} + 20\text{ (bottom padding)}, \quad 1 \le N \le 7.
+    \]
+  - The **last line is always on the same baseline as the arrow** on the right.
+  - Visually, the bar grows **upwards**; the arrow + last line stay fixed at the bottom.
+
+#### 8 lines: text reaches the top edge
+
+- When the **8th line** appears:
+  - The text block now reaches the **top edge of the bottom bar**.  
+  - The bar height is at its **maximum** (e.g. 180 px).  
+  - All 8 lines are still visible at once, from the top edge down to the arrow.
+
+#### 9 lines: full‑height text area, one line hidden
+
+- When the **9th line** appears:
+  - The **scrollable text area is exactly 180 px high**, the same as the bar.  
+  - The **last line remains aligned with the arrow** at the bottom.  
+  - The **topmost line (1st)** is now hidden just above the top edge of the bar.  
+  - If the user scrolls, they can reveal all 9 lines, because:
+    \[
+    9 \times 20\text{ px} = 180\text{ px},
+    \]
+    so all 9 lines can fit into the bar’s full height when scrolled to the appropriate position.
+
+#### 9+ lines: fixed bar, 9‑line scrolling window
+
+- For **any number of lines ≥ 9**:
+  - The bar height stays fixed at its maximum (e.g. 180 px).  
+  - The **scrollable area always occupies the full bar height** (180 px).  
+  - At any moment:
+    - Up to **9 lines are visible** in the window.  
+    - The **bottom (last visible) line stays aligned with the arrow** while typing.  
+    - Older lines scroll upwards and are hidden above the top edge; the user can scroll to reveal them.
+
+---
+
+### 3. Implementation‑oriented summary
+
+- **Line height & padding**
+  - Line height: 20 px.
+  - Top padding: 20 px.
+  - Bottom padding: 20 px.
+
+- **Bar growth vs. scroll mode**
+  - For 1–7 lines, bar height grows; arrow + last line baseline are fixed.  
+  - From the 8th line onward, the bar stays at max height; the input switches to a scrollable window that:
+    - Always keeps the caret / last line baseline aligned with the arrow.
+    - Hides older lines under the top edge while allowing them to be revealed by scrolling.
+