@aliou/pi-linkup 0.1.0 → 0.3.0

package/.github/workflows/publish.yml

@@ -4,6 +4,12 @@ on:
   push:
     branches:
       - main
+  workflow_dispatch:
+    inputs:
+      skip-checks:
+        description: "Skip lint and typecheck"
+        type: boolean
+        default: false
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -11,6 +17,7 @@ concurrency:
 
 jobs:
   check:
+    if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.skip-checks) }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -34,6 +41,7 @@ jobs:
   publish:
     name: Publish
     needs: check
+    if: ${{ always() && (needs.check.result == 'success' || needs.check.result == 'skipped') }}
     runs-on: ubuntu-latest
     permissions:
       contents: write

package/AGENTS.md

@@ -0,0 +1,48 @@
+# pi-linkup
+
+Public Pi extension providing web search, answer, and fetch tools via the Linkup API. People could be using this, so consider backwards compatibility when making changes.
+
+Pi is pre-1.0.0, so breaking changes can happen between Pi versions. This extension must stay up to date with Pi or things will break.
+
+## Stack
+
+- TypeScript (strict mode)
+- pnpm 10.26.1
+- Biome for linting/formatting
+- Changesets for versioning
+
+## Scripts
+
+```bash
+pnpm typecheck    # Type check
+pnpm lint         # Lint (runs on pre-commit)
+pnpm format       # Format
+pnpm changeset    # Create changeset for versioning
+```
+
+## Structure
+
+```
+src/
+  index.ts        # Extension entry, registers tools and commands
+  client.ts       # Linkup API client
+  types.ts        # Shared types
+  tools/          # Tool implementations
+  commands/       # Command implementations
+skills/
+  linkup/SKILL.md # Skill docs for agents using this extension
+```
+
+## Conventions
+
+- New tools: follow patterns in `src/tools/`
+- API keys come from environment (`LINKUP_API_KEY`)
+- Update `skills/linkup/SKILL.md` when tool behavior changes
+
+## Versioning
+
+Uses changesets. Run `pnpm changeset` before committing user-facing changes.
+
+- `patch`: bug fixes
+- `minor`: new features/tools
+- `major`: breaking changes

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @aliou/pi-linkup
+
+## 0.3.0
+
+### Minor Changes
+
+- e57f6fe: Enhanced balance command to show remaining requests per operation type (standard search, deep search, fetch with/without JS) using a themed custom message renderer instead of a transient notification.
+
+## 0.2.0
+
+### Minor Changes
+
+- 2307674: Update pi packages to 0.51.0. Adapt tool execute signatures to new parameter order.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-linkup",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/aliou/pi-linkup"
@@ -19,8 +19,8 @@
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
     "@changesets/cli": "^2.27.11",
-    "@mariozechner/pi-coding-agent": "^0.50.1",
-    "@mariozechner/pi-tui": "^0.50.1",
+    "@mariozechner/pi-coding-agent": "0.51.0",
+    "@mariozechner/pi-tui": "0.51.0",
     "@sinclair/typebox": "^0.34.48",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",

package/src/commands/balance.ts

@@ -9,10 +9,12 @@ export function registerBalanceCommand(pi: ExtensionAPI) {
 
       try {
         const response = await client.getBalance();
-        ctx.ui.notify(
-          `Linkup Balance: ${response.balance.toFixed(2)} credits`,
-          "info",
-        );
+        pi.sendMessage({
+          customType: "linkup-balance",
+          content: `Linkup Balance: ${response.balance.toFixed(2)} credits`,
+          display: true,
+          details: { balance: response.balance },
+        });
       } catch (error) {
         const message =
           error instanceof Error ? error.message : "Unknown error";

package/src/components/balance-renderer.ts

@@ -0,0 +1,45 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { Box, Text } from "@mariozechner/pi-tui";
+import { LINKUP_PRICING } from "../types";
+
+export function registerBalanceRenderer(pi: ExtensionAPI) {
+  pi.registerMessageRenderer("linkup-balance", (message, _options, theme) => {
+    const details = message.details as { balance: number };
+    const balance = details.balance;
+
+    // Build header line
+    const header = [
+      theme.fg("accent", "Linkup"),
+      theme.fg("muted", " · "),
+      theme.fg("muted", `${balance} credits`),
+    ].join("");
+
+    // Calculate remaining requests for each operation type
+    const remaining = {
+      standardSearch: Math.floor(balance / LINKUP_PRICING.standardSearch),
+      deepSearch: Math.floor(balance / LINKUP_PRICING.deepSearch),
+      fetchNoJs: Math.floor(balance / LINKUP_PRICING.fetchNoJs),
+      fetchWithJs: Math.floor(balance / LINKUP_PRICING.fetchWithJs),
+    };
+
+    // Format number with locale string and ~ prefix
+    const fmt = (num: number): string => `~${num.toLocaleString()}`;
+
+    // Table rows with right-aligned numbers (padded to 7 chars)
+    const row = (num: number, label: string) =>
+      `${theme.fg("accent", fmt(num).padStart(7))}  ${theme.fg("dim", label)}`;
+
+    const lines = [
+      header,
+      "",
+      row(remaining.standardSearch, "standard searches"),
+      row(remaining.deepSearch, "deep searches"),
+      row(remaining.fetchNoJs, "fetches (no JS)"),
+      row(remaining.fetchWithJs, "fetches (with JS)"),
+    ].join("\n");
+
+    const box = new Box(1, 1, (t) => theme.bg("customMessageBg", t));
+    box.addChild(new Text(lines, 0, 0));
+    return box;
+  });
+}

package/src/components/index.ts

@@ -0,0 +1,6 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { registerBalanceRenderer } from "./balance-renderer";
+
+export function registerRenderers(pi: ExtensionAPI) {
+  registerBalanceRenderer(pi);
+}

package/src/index.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { registerBalanceCommand } from "./commands/balance";
+import { registerRenderers } from "./components";
 import { registerWebAnswerTool } from "./tools/web-answer";
 import { registerWebFetchTool } from "./tools/web-fetch";
 import { registerWebSearchTool } from "./tools/web-search";
@@ -30,4 +31,7 @@ export default function (pi: ExtensionAPI) {
 
   // Register commands
   registerBalanceCommand(pi);
+
+  // Register renderers
+  registerRenderers(pi);
 }

package/src/tools/web-answer.ts

@@ -31,7 +31,7 @@ export function registerWebAnswerTool(pi: ExtensionAPI) {
       ),
     }),
 
-    async execute(_toolCallId, params, onUpdate, _ctx, _signal) {
+    async execute(_toolCallId, params, _signal, onUpdate, _ctx) {
       const client = getClient();
 
       try {

package/src/tools/web-fetch.ts

@@ -28,7 +28,7 @@ export function registerWebFetchTool(pi: ExtensionAPI) {
       ),
     }),
 
-    async execute(_toolCallId, params, onUpdate, _ctx, _signal) {
+    async execute(_toolCallId, params, _signal, onUpdate, _ctx) {
       const client = getClient();
 
       try {

package/src/tools/web-search.ts

@@ -30,7 +30,7 @@ export function registerWebSearchTool(pi: ExtensionAPI) {
       ),
     }),
 
-    async execute(_toolCallId, params, onUpdate, _ctx, _signal) {
+    async execute(_toolCallId, params, _signal, onUpdate, _ctx) {
       const client = getClient();
 
       try {

package/src/types.ts

@@ -32,3 +32,14 @@ export interface LinkupErrorResponse {
     message?: string;
   };
 }
+
+/**
+ * Credit cost per request by operation type.
+ * Source: https://docs.linkup.so/pages/documentation/development/pricing
+ */
+export const LINKUP_PRICING = {
+  standardSearch: 0.005,
+  deepSearch: 0.05,
+  fetchNoJs: 0.001,
+  fetchWithJs: 0.005,
+} as const;