@bixbd/utils-mcp 0.1.0-beta.5 → 0.1.0-beta.6

package/dist/cli.js

@@ -4504,44 +4504,10 @@ var init_src = __esm(() => {
   init_registry();
 });
 
-// ../../connectors/desco/src/schemas.ts
-var RawAccounts, RawBalance, RawRealtime, AccountsOut, BalanceOut, RealtimeOut;
-var init_schemas3 = __esm(() => {
+// ../../connectors/desco/src/schemas/out.ts
+var AccountsOut, BalanceOut, RealtimeOut, DataOut;
+var init_out = __esm(() => {
   init_src();
-  RawAccounts = object({
-    accounts: array(object({
-      accountId: number2(),
-      accountNo: string2().nullish(),
-      meterNo: string2().nullish(),
-      status: string2().nullish(),
-      linkStatus: string2().nullish()
-    }))
-  });
-  RawBalance = object({
-    balance: number2().nullish(),
-    currency: string2().nullish(),
-    balanceSnapshotAt: string2().nullish(),
-    timestampAvailable: boolean2().optional(),
-    stale: boolean2().optional(),
-    currentMonthConsumedTaka: number2().nullish(),
-    readingTime: string2().nullish(),
-    consumerMessages: array(unknown()).optional()
-  });
-  RawRealtime = object({
-    enabled: boolean2().optional(),
-    meters: array(object({
-      accountId: number2().nullish(),
-      meterNo: string2().nullish(),
-      meterType: string2().nullish(),
-      status: string2().nullish(),
-      message: string2().nullish(),
-      lastRealtimeBalance: number2().nullish(),
-      lastRealtimeReceivedAt: string2().nullish(),
-      nextEligibleAt: string2().nullish(),
-      attemptsToday: number2().nullish(),
-      remainingAttempts: number2().nullish()
-    }))
-  });
   AccountsOut = object({
     accounts: array(object({
       accountId: number2(),
@@ -4577,14 +4543,66 @@ var init_schemas3 = __esm(() => {
       remainingAttempts: number2().nullable()
     }))
   });
+  DataOut = object({ data: unknown() });
 });
 
-// ../../connectors/desco/src/index.ts
-var exports_src = {};
-__export(exports_src, {
-  default: () => src_default,
-  desco: () => desco
+// ../../connectors/desco/src/schemas/raw.ts
+var RawAccounts, RawBalance, RawRealtime;
+var init_raw = __esm(() => {
+  init_src();
+  RawAccounts = object({
+    accounts: array(object({
+      accountId: number2(),
+      accountNo: string2().nullish(),
+      meterNo: string2().nullish(),
+      status: string2().nullish(),
+      linkStatus: string2().nullish()
+    }))
+  });
+  RawBalance = object({
+    balance: number2().nullish(),
+    currency: string2().nullish(),
+    balanceSnapshotAt: string2().nullish(),
+    timestampAvailable: boolean2().optional(),
+    stale: boolean2().optional(),
+    currentMonthConsumedTaka: number2().nullish(),
+    readingTime: string2().nullish(),
+    consumerMessages: array(unknown()).optional()
+  });
+  RawRealtime = object({
+    enabled: boolean2().optional(),
+    meters: array(object({
+      accountId: number2().nullish(),
+      meterNo: string2().nullish(),
+      meterType: string2().nullish(),
+      status: string2().nullish(),
+      message: string2().nullish(),
+      lastRealtimeBalance: number2().nullish(),
+      lastRealtimeReceivedAt: string2().nullish(),
+      nextEligibleAt: string2().nullish(),
+      attemptsToday: number2().nullish(),
+      remainingAttempts: number2().nullish()
+    }))
+  });
+});
+
+// ../../connectors/desco/src/schemas/index.ts
+var init_schemas3 = __esm(() => {
+  init_out();
+  init_raw();
 });
+
+// ../../connectors/desco/src/client/accounts.ts
+async function listAccounts(ctx) {
+  const raw = await ctx.http.json("/accounts", RawAccounts);
+  return raw.accounts.map((account) => ({
+    accountId: account.accountId,
+    accountNoLast4: maskLast4(account.accountNo),
+    meterNoLast4: maskLast4(account.meterNo),
+    status: account.status ?? null,
+    linkStatus: account.linkStatus ?? null
+  }));
+}
 async function resolveAccountId(ctx) {
   const accounts = await listAccounts(ctx);
   const only = accounts[0];
@@ -4597,92 +4615,294 @@ async function resolveAccountId(ctx) {
   }
   return only.accountId;
 }
-var listAccounts = async (ctx) => {
-  const raw = await ctx.http.json("/accounts", RawAccounts);
-  return raw.accounts.map((account) => ({
-    accountId: account.accountId,
-    accountNoLast4: maskLast4(account.accountNo),
-    meterNoLast4: maskLast4(account.meterNo),
-    status: account.status ?? null,
-    linkStatus: account.linkStatus ?? null
-  }));
-}, desco, src_default;
-var init_src2 = __esm(() => {
+var init_accounts = __esm(() => {
+  init_src();
+  init_schemas3();
+});
+
+// ../../connectors/desco/src/client/query.ts
+function withQuery(path, query) {
+  const params = new URLSearchParams;
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== undefined && value !== "") {
+      params.set(key, String(value));
+    }
+  }
+  const text = params.toString();
+  return text ? `${path}?${text}` : path;
+}
+
+// ../../connectors/desco/src/client/redact.ts
+function redact(value) {
+  if (Array.isArray(value)) {
+    return value.map(redact);
+  }
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, v]) => [
+      key,
+      MASKED_KEYS.has(key) && typeof v === "string" ? maskLast4(v) : redact(v)
+    ]));
+  }
+  return value;
+}
+var MASKED_KEYS;
+var init_redact = __esm(() => {
+  init_src();
+  MASKED_KEYS = new Set(["accountNo", "meterNo", "consumerNo"]);
+});
+
+// ../../connectors/desco/src/client/index.ts
+var init_client = __esm(() => {
+  init_accounts();
+  init_redact();
+});
+
+// ../../connectors/desco/src/tools/factories.ts
+var Loose, accountIdInput, dateInput, monthInput, publicGet = (name, description, path) => defineTool({
+  name,
+  description,
+  access: "read",
+  input: object({}),
+  output: DataOut,
+  handler: async (_input, ctx) => ({ data: await ctx.http.json(path, Loose) })
+}), publicSearch = (name, description, path, shape) => defineTool({
+  name,
+  description,
+  access: "read",
+  input: object({
+    ...shape,
+    page: number2().int().min(0).optional().describe("Zero-based page number."),
+    size: number2().int().min(1).max(50).optional().describe("Results per page.")
+  }),
+  output: DataOut,
+  handler: async (input, ctx) => ({
+    data: await ctx.http.json(withQuery(path, input), Loose)
+  })
+}), accountGet = (name, description, suffix, shape = {}) => defineTool({
+  name,
+  description,
+  access: "read",
+  input: object({ accountId: accountIdInput, ...shape }),
+  output: DataOut,
+  handler: async (input, ctx) => {
+    const { accountId: given, ...query } = input;
+    const accountId = given ?? await resolveAccountId(ctx);
+    const path = withQuery(`/accounts/${accountId}${suffix}`, query);
+    return { data: redact(await ctx.http.json(path, Loose)) };
+  }
+});
+var init_factories = __esm(() => {
   init_src();
+  init_client();
   init_schemas3();
+  Loose = unknown();
+  accountIdInput = number2().int().positive().optional().describe("Internal accountId from desco_list_accounts. Omit if only one account is linked.");
+  dateInput = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "Use YYYY-MM-DD").optional();
+  monthInput = string2().regex(/^\d{4}-\d{2}$/, "Use YYYY-MM").optional();
+});
+
+// ../../connectors/desco/src/tools/accounts.ts
+var listAccountsTool, getBalance, getRealtimeStatus, accountTools;
+var init_accounts2 = __esm(() => {
+  init_src();
+  init_client();
+  init_schemas3();
+  init_factories();
+  listAccountsTool = defineTool({
+    name: "list_accounts",
+    description: "List the DESCO prepaid accounts linked to the signed-in user, with account IDs. Use first when the user has not given an accountId.",
+    access: "read",
+    input: object({}),
+    output: AccountsOut,
+    handler: async (_input, ctx) => ({ accounts: await listAccounts(ctx) })
+  });
+  getBalance = defineTool({
+    name: "get_balance",
+    description: "Get the daily prepaid electricity balance in BDT for a DESCO account. Use when asked about meter balance or remaining credit. Omit accountId if only one account is linked.",
+    access: "read",
+    input: object({ accountId: accountIdInput }),
+    output: BalanceOut,
+    handler: async (input, ctx) => {
+      const accountId = input.accountId ?? await resolveAccountId(ctx);
+      const raw = await ctx.http.json(`/accounts/${accountId}/balance`, RawBalance);
+      const balance = raw.balance ?? null;
+      const timestampAvailable = raw.timestampAvailable !== false;
+      const unavailable = balance === null || !timestampAvailable;
+      return {
+        balance,
+        currency: raw.currency ?? null,
+        balanceSnapshotAt: raw.balanceSnapshotAt ?? null,
+        timestampAvailable,
+        stale: raw.stale === true,
+        currentMonthConsumedTaka: raw.currentMonthConsumedTaka ?? null,
+        readingTime: raw.readingTime ?? null,
+        consumerMessages: raw.consumerMessages ?? [],
+        note: unavailable ? "The balance is unavailable right now. Do not treat it as zero." : "This is a daily snapshot, not a live meter reading. A recent recharge may not appear until the next update."
+      };
+    }
+  });
+  getRealtimeStatus = defineTool({
+    name: "get_realtime_status",
+    description: "Read the last realtime-reading result and whether a new reading is allowed, per meter. Use to explain realtime limits. It does not request a new reading.",
+    access: "read",
+    input: object({}),
+    output: RealtimeOut,
+    handler: async (_input, ctx) => {
+      const raw = await ctx.http.json("/accounts/realtime-balance", RawRealtime);
+      return {
+        enabled: raw.enabled === true,
+        meters: raw.meters.map((meter) => ({
+          accountId: meter.accountId ?? null,
+          meterNoLast4: maskLast4(meter.meterNo),
+          meterType: meter.meterType ?? null,
+          status: meter.status ?? null,
+          message: meter.message ?? null,
+          lastRealtimeBalance: meter.lastRealtimeBalance ?? null,
+          lastRealtimeReceivedAt: meter.lastRealtimeReceivedAt ?? null,
+          nextEligibleAt: meter.nextEligibleAt ?? null,
+          attemptsToday: meter.attemptsToday ?? null,
+          remainingAttempts: meter.remainingAttempts ?? null
+        }))
+      };
+    }
+  });
+  accountTools = [listAccountsTool, getBalance, getRealtimeStatus];
+});
+
+// ../../connectors/desco/src/tools/billing.ts
+var billingTools;
+var init_billing = __esm(() => {
+  init_factories();
+  billingTools = [
+    accountGet("get_recharge_history", "Recharge transactions for a date range (YYYY-MM-DD).", "/transactions", {
+      dateFrom: dateInput,
+      dateTo: dateInput
+    }),
+    accountGet("get_token_history", "Recharge tokens issued for a date range (YYYY-MM-DD). Tokens are credentials for the meter, so share them only with the account owner.", "/tokens", { dateFrom: dateInput, dateTo: dateInput }),
+    accountGet("get_token_resend_eligibility", "Whether a recharge token can be re-sent for this account. Does not send anything.", "/token-resend/eligibility")
+  ];
+});
+
+// ../../connectors/desco/src/tools/directory.ts
+var directoryTools;
+var init_directory = __esm(() => {
+  init_src();
+  init_factories();
+  directoryTools = [
+    publicSearch("find_recharge_points", "Search DESCO prepaid recharge points (POS shops) by text, bank or area. Bank and area values must match the portal exactly, for example bank 'MYCash', area 'Mirpur'.", "/public/pos-locations", {
+      q: string2().optional().describe("Free-text search on shop name or address."),
+      bank: string2().optional(),
+      area: string2().optional()
+    }),
+    publicGet("list_recharge_point_filters", "Valid bank and area values for find_recharge_points.", "/public/pos-locations/filters"),
+    publicSearch("find_meter_manuals", "Search prepaid meter user manuals (PDF) by manufacturer, phase (SINGLE or THREE) and language.", "/public/meter-manuals", {
+      q: string2().optional(),
+      manufacturer: string2().optional(),
+      phase: _enum(["SINGLE", "THREE"]).optional(),
+      locale: string2().optional()
+    }),
+    publicSearch("find_tutorials", "Search DESCO prepaid video tutorials by text, category and language.", "/public/tutorials", {
+      q: string2().optional(),
+      category: string2().optional(),
+      locale: string2().optional()
+    })
+  ];
+});
+
+// ../../connectors/desco/src/tools/info.ts
+var listNotices, infoTools;
+var init_info = __esm(() => {
+  init_src();
+  init_schemas3();
+  init_factories();
+  listNotices = defineTool({
+    name: "list_notices",
+    description: "Active DESCO portal notices, or the important homepage notices (monthly charges, recharge deductions).",
+    access: "read",
+    input: object({ kind: _enum(["active", "homepage"]).default("active") }),
+    output: DataOut,
+    handler: async (input, ctx) => ({ data: await ctx.http.json(`/public/notices/${input.kind}`, unknown()) })
+  });
+  infoTools = [
+    publicGet("get_tariff", "Current DESCO retail electricity tariff: unit slabs, rates per kWh and demand charges by customer class. Use for price-per-unit questions.", "/public/tariff-schedules/current"),
+    listNotices,
+    publicGet("list_faqs", "DESCO prepaid FAQ in Bangla and English.", "/public/faqs"),
+    publicGet("list_short_codes", "Prepaid meter keypad short codes (e.g. 801 shows balance), grouped by purpose, with meter and phase applicability.", "/public/prepaid-short-codes"),
+    publicGet("list_tariff_documents", "Current tariff orders and circulars published by DESCO, with titles and summaries.", "/public/documents/tariffs/current"),
+    publicGet("list_documents", "All published DESCO tariff documents, forms, circulars and policies.", "/public/documents")
+  ];
+});
+
+// ../../connectors/desco/src/tools/profile.ts
+var profileTools;
+var init_profile = __esm(() => {
+  init_factories();
+  profileTools = [
+    accountGet("get_account_summary", "Summary of a DESCO prepaid account: customer, meter and connection details.", "/summary"),
+    accountGet("get_contact_office", "The DESCO office that serves this account: name, address and phone.", "/contact-office")
+  ];
+});
+
+// ../../connectors/desco/src/tools/usage.ts
+var usageTools;
+var init_usage = __esm(() => {
+  init_src();
+  init_factories();
+  usageTools = [
+    accountGet("get_daily_usage", "Daily electricity usage for a date range. Dates are YYYY-MM-DD.", "/usage/daily", {
+      dateFrom: dateInput,
+      dateTo: dateInput
+    }),
+    accountGet("get_monthly_usage", "Monthly electricity usage for a month range. Months are YYYY-MM.", "/usage/monthly", {
+      monthFrom: monthInput,
+      monthTo: monthInput
+    }),
+    accountGet("get_consumption_comparison", "Compare monthly consumption this year against last year, up to an end month.", "/consumption-comparison", { year: number2().int().min(2000).max(2100).optional(), endMonth: number2().int().min(1).max(12).optional() }),
+    accountGet("get_energy_vs_consumed_taka", "Energy (kWh) versus money consumed (BDT) per month. Months are YYYY-MM.", "/energy-vs-consumed-taka", { monthFrom: monthInput, monthTo: monthInput })
+  ];
+});
+
+// ../../connectors/desco/src/tools/index.ts
+var tools;
+var init_tools = __esm(() => {
+  init_accounts2();
+  init_billing();
+  init_directory();
+  init_info();
+  init_profile();
+  init_usage();
+  tools = [
+    ...accountTools,
+    ...profileTools,
+    ...usageTools,
+    ...billingTools,
+    ...infoTools,
+    ...directoryTools
+  ];
+});
+
+// ../../connectors/desco/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  default: () => src_default,
+  desco: () => desco
+});
+var desco, src_default;
+var init_src2 = __esm(() => {
+  init_src();
+  init_tools();
   desco = defineConnector({
     id: "desco",
-    version: "0.2.0",
+    version: "0.3.0",
     status: "beta",
-    description: "DESCO prepaid electricity: linked accounts and balance (unofficial)",
+    description: "DESCO prepaid electricity: accounts, balance, usage, recharges, tariffs, notices and recharge points (unofficial)",
     baseUrl: "https://prepaid.desco.org.bd/api",
     auth: formLogin({
       csrfPath: "/auth/csrf",
       loginPath: "/auth/login",
       secrets: { username: "DESCO_USERNAME", password: "DESCO_PASSWORD" }
     }),
-    tools: [
-      defineTool({
-        name: "list_accounts",
-        description: "List the DESCO prepaid accounts linked to the signed-in user, with account IDs. Use first when the user has not given an accountId.",
-        access: "read",
-        input: object({}),
-        output: AccountsOut,
-        handler: async (_input, ctx) => ({ accounts: await listAccounts(ctx) })
-      }),
-      defineTool({
-        name: "get_balance",
-        description: "Get the daily prepaid electricity balance in BDT for a DESCO account. Use when asked about meter balance or remaining credit. Omit accountId if only one account is linked.",
-        access: "read",
-        input: object({
-          accountId: number2().int().positive().optional().describe("Internal accountId from list_accounts, not the account or meter number.")
-        }),
-        output: BalanceOut,
-        handler: async (input, ctx) => {
-          const accountId = input.accountId ?? await resolveAccountId(ctx);
-          const raw = await ctx.http.json(`/accounts/${accountId}/balance`, RawBalance);
-          const balance = raw.balance ?? null;
-          const timestampAvailable = raw.timestampAvailable !== false;
-          const unavailable = balance === null || !timestampAvailable;
-          return {
-            balance,
-            currency: raw.currency ?? null,
-            balanceSnapshotAt: raw.balanceSnapshotAt ?? null,
-            timestampAvailable,
-            stale: raw.stale === true,
-            currentMonthConsumedTaka: raw.currentMonthConsumedTaka ?? null,
-            readingTime: raw.readingTime ?? null,
-            consumerMessages: raw.consumerMessages ?? [],
-            note: unavailable ? "The balance is unavailable right now. Do not treat it as zero." : "This is a daily snapshot, not a live meter reading. A recent recharge may not appear until the next update."
-          };
-        }
-      }),
-      defineTool({
-        name: "get_realtime_status",
-        description: "Read the last realtime-reading result and whether a new reading is allowed, per meter. Use to explain realtime limits. It does not request a new reading.",
-        access: "read",
-        input: object({}),
-        output: RealtimeOut,
-        handler: async (_input, ctx) => {
-          const raw = await ctx.http.json("/accounts/realtime-balance", RawRealtime);
-          return {
-            enabled: raw.enabled === true,
-            meters: raw.meters.map((meter) => ({
-              accountId: meter.accountId ?? null,
-              meterNoLast4: maskLast4(meter.meterNo),
-              meterType: meter.meterType ?? null,
-              status: meter.status ?? null,
-              message: meter.message ?? null,
-              lastRealtimeBalance: meter.lastRealtimeBalance ?? null,
-              lastRealtimeReceivedAt: meter.lastRealtimeReceivedAt ?? null,
-              nextEligibleAt: meter.nextEligibleAt ?? null,
-              attemptsToday: meter.attemptsToday ?? null,
-              remainingAttempts: meter.remainingAttempts ?? null
-            }))
-          };
-        }
-      })
-    ]
+    tools
   });
   src_default = desco;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bixbd/utils-mcp",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-beta.6",
   "description": "Connect utility portals to AI agents through MCP. Works with any MCP app via npx; credentials stay on your machine.",
   "keywords": [
     "mcp",
@@ -47,8 +47,8 @@
   },
   "devDependencies": {
     "@bixbd/utils-mcp-connector-example": "0.0.0",
-    "@bixbd/utils-mcp-connector-desco": "0.1.0-beta.5",
-    "@bixbd/utils-mcp-core": "0.1.0-beta.5",
+    "@bixbd/utils-mcp-connector-desco": "0.1.0-beta.6",
+    "@bixbd/utils-mcp-core": "0.1.0-beta.6",
     "@modelcontextprotocol/sdk": "^1.0.0"
   }
 }