agent-banner-library 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 0.0.1
+
+- Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Auronforge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# agent-banner-library
+
+Reusable Node.js + TypeScript library to standardize startup banner logs for REST API agents.
+
+## Installation
+
+```bash
+npm install agent-banner-library
+```
+
+## Usage
+
+### Express
+
+```ts
+import express from 'express';
+import { printAgentBanner } from 'agent-banner-library';
+
+const app = express();
+const port = 3001;
+
+app.listen(port, () => {
+  printAgentBanner({
+    agentName: 'Backlog Structurer Agent API',
+    baseUrl: `http://localhost:${port}`,
+    prefix: '/api/v1',
+    endpoints: [
+      {
+        method: 'POST',
+        path: '/backlog/structure',
+        description: 'Generate structured backlog',
+      },
+    ],
+  });
+});
+```
+
+### Fastify
+
+```ts
+import Fastify from 'fastify';
+import { renderAgentBanner } from 'agent-banner-library';
+
+const app = Fastify();
+const port = 3002;
+
+await app.listen({ port });
+
+const banner = renderAgentBanner({
+  agentName: 'Capability Mapper',
+  baseUrl: `http://localhost:${port}`,
+  prefix: 'api/v1',
+  endpoints: [
+    {
+      method: 'GET',
+      path: 'capabilities',
+      description: 'List capabilities',
+    },
+  ],
+});
+
+app.log.info(banner);
+```
+
+## Configuration
+
+```ts
+export interface AgentBannerConfig {
+  agentName: string;
+  packageJsonPath?: string;
+  version?: string;
+  baseUrl: string;
+  prefix: string;
+  docsPath?: string;
+  healthPath?: string;
+  endpoints?: Array<{
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+    path: string;
+    description: string;
+  }>;
+  environment?: string;
+  timestamp?: string | Date;
+  width?: number;
+  emoji?: boolean;
+}
+```
+
+Default behaviors:
+
+- `packageJsonPath` defaults to `process.cwd() + "/package.json"`.
+- `version` is read from `package.json` if not provided, or `0.0.0` on failure.
+- `prefix` and `path` are normalized to start with `/` and avoid double slashes.
+- `docsPath` defaults to `/docs` and `healthPath` to `/health`.
+- `environment` defaults to `process.env.NODE_ENV ?? "development"`.
+- `timestamp` defaults to `new Date()` and is always rendered as ISO.
+- `width` defaults to 48 characters.
+- `emoji` defaults to `true`.
+
+## Sample Output
+
+```
+════════════════════════════════════════════════════════
+🚀 Backlog Structurer Agent API - 1.2.3
+════════════════════════════════════════════════════════
+📡 Server running on: http://localhost:3001
+📚 API Documentation: http://localhost:3001/api/v1/docs
+🏥 Health Check: http://localhost:3001/api/v1/health
+📝 Endpoints:
+    - POST - Generate structured backlog - http://localhost:3001/api/v1/backlog/structure
+════════════════════════════════════════════════════════
+Environment: development
+Timestamp: 2026-02-05T23:49:50.079Z
+════════════════════════════════════════════════════════
+```
+
+## ESM/CJS
+
+- ESM: `import { renderAgentBanner } from "agent-banner-library"`.
+- CJS: `const { renderAgentBanner } = require("agent-banner-library")`.
+
+## TSLint
+
+TSLint is deprecated but included for legacy compatibility as required. It is not used by default in CI.
+
+## Development
+
+```bash
+npm run lint
+npm run typecheck
+npm run test:coverage
+```
+
+## Tooling Configs
+
+- lint-staged: [.lintstagedrc.cjs](.lintstagedrc.cjs)
+- standard-version: [.versionrc.cjs](.versionrc.cjs) and `npm run release`
+
+## CI/CD
+
+- CI workflow: [.github/workflows/ci.yml](.github/workflows/ci.yml)
+- Release workflow: [.github/workflows/release.yml](.github/workflows/release.yml)

package/dist/cjs/banner.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentBanner = renderAgentBanner;
+exports.printAgentBanner = printAgentBanner;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const format_1 = require("./format");
+function resolveVersion(packageJsonPath, override) {
+    if (override) {
+        return override;
+    }
+    try {
+        const raw = node_fs_1.default.readFileSync(packageJsonPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.version === 'string' && parsed.version.trim()) {
+            return parsed.version.trim();
+        }
+    }
+    catch {
+        return '0.0.0';
+    }
+    return '0.0.0';
+}
+function renderAgentBanner(config) {
+    const baseUrl = (0, format_1.normalizeBaseUrl)(config.baseUrl);
+    const prefix = (0, format_1.normalizePrefix)(config.prefix);
+    const docsPath = (0, format_1.normalizePath)(config.docsPath ?? '/docs');
+    const healthPath = (0, format_1.normalizePath)(config.healthPath ?? '/health');
+    const endpoints = config.endpoints ?? [];
+    const packageJsonPath = config.packageJsonPath ?? node_path_1.default.join(process.cwd(), 'package.json');
+    const version = resolveVersion(packageJsonPath, config.version);
+    const environment = config.environment ?? process.env.NODE_ENV ?? 'development';
+    const timestamp = (0, format_1.toIsoTimestamp)(config.timestamp);
+    const width = config.width ?? format_1.DEFAULT_BANNER_WIDTH;
+    const border = (0, format_1.getBorder)(width);
+    const emoji = config.emoji ?? true;
+    const rocket = emoji ? '🚀 ' : '';
+    const server = emoji ? '📡 ' : '';
+    const docs = emoji ? '📚 ' : '';
+    const health = emoji ? '🏥 ' : '';
+    const endpointsLabel = emoji ? '📝 ' : '';
+    const docsUrl = (0, format_1.urlJoin)(baseUrl, prefix, docsPath);
+    const healthUrl = (0, format_1.urlJoin)(baseUrl, prefix, healthPath);
+    const endpointLines = endpoints.length
+        ? endpoints.map((endpoint) => {
+            const endpointPath = (0, format_1.normalizePath)(endpoint.path);
+            const endpointUrl = (0, format_1.urlJoin)(baseUrl, prefix, endpointPath);
+            return `    - ${endpoint.method} - ${endpoint.description} - ${endpointUrl}`;
+        })
+        : ['    - (none)'];
+    const lines = [
+        border,
+        `${rocket}${config.agentName} - ${version}`,
+        border,
+        `${server}Server running on: ${baseUrl}`,
+        `${docs}API Documentation: ${docsUrl}`,
+        `${health}Health Check: ${healthUrl}`,
+        `${endpointsLabel}Endpoints:`,
+        ...endpointLines,
+        border,
+        `Environment: ${environment}`,
+        `Timestamp: ${timestamp}`,
+        border,
+    ];
+    return `${lines.join('\n')}\n`;
+}
+function printAgentBanner(config, logger = console) {
+    logger.log(renderAgentBanner(config));
+}
+//# sourceMappingURL=banner.cjs.map

package/dist/cjs/banner.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "banner.cjs",
+  "sourceRoot": "",
+  "sources": [
+    "../../src/banner.ts"
+  ],
+  "names": [],
+  "mappings": ";;;;;AAgCA,8CA+CC;AAED,4CAKC;AAtFD,sDAAyB;AACzB,0DAA6B;AAG7B,qCAQkB;AAElB,SAAS,cAAc,CAAC,eAAuB,EAAE,QAAiB;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,MAAM,OAAO,GAAG,IAAA,yBAAgB,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAA,wBAAe,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IAChF,MAAM,SAAS,GAAG,IAAA,uBAAc,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,6BAAoB,CAAC;IACnD,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,KAAK,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAEnC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAA,gBAAO,EAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAA,gBAAO,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAEvD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM;QACpC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YACzB,MAAM,YAAY,GAAG,IAAA,sBAAa,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,WAAW,GAAG,IAAA,gBAAO,EAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YAC3D,OAAO,SAAS,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,WAAW,MAAM,WAAW,EAAE,CAAC;QAC/E,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAErB,MAAM,KAAK,GAAG;QACZ,MAAM;QACN,GAAG,MAAM,GAAG,MAAM,CAAC,SAAS,MAAM,OAAO,EAAE;QAC3C,MAAM;QACN,GAAG,MAAM,sBAAsB,OAAO,EAAE;QACxC,GAAG,IAAI,sBAAsB,OAAO,EAAE;QACtC,GAAG,MAAM,iBAAiB,SAAS,EAAE;QACrC,GAAG,cAAc,YAAY;QAC7B,GAAG,aAAa;QAChB,MAAM;QACN,gBAAgB,WAAW,EAAE;QAC7B,cAAc,SAAS,EAAE;QACzB,MAAM;KACP,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAgB,gBAAgB,CAC9B,MAAyB,EACzB,SAA+B,OAAO;IAEtC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AACxC,CAAC"
+}

package/dist/cjs/format.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BORDER_CHAR = exports.DEFAULT_BANNER_WIDTH = void 0;
+exports.getBorder = getBorder;
+exports.normalizeBaseUrl = normalizeBaseUrl;
+exports.normalizePrefix = normalizePrefix;
+exports.normalizePath = normalizePath;
+exports.toIsoTimestamp = toIsoTimestamp;
+exports.urlJoin = urlJoin;
+exports.DEFAULT_BANNER_WIDTH = 48;
+exports.BORDER_CHAR = '═';
+function getBorder(width) {
+    const safeWidth = Number.isFinite(width) && width > 0 ? Math.floor(width) : exports.DEFAULT_BANNER_WIDTH;
+    return exports.BORDER_CHAR.repeat(safeWidth);
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.trim().replace(/\/+$/, '');
+}
+function normalizePrefix(prefix) {
+    const trimmed = prefix.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/';
+    }
+    let value = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    value = value.replace(/\/+$/, '');
+    return value || '/';
+}
+function normalizePath(pathValue) {
+    const trimmed = pathValue.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/';
+    }
+    let value = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    value = value.replace(/\/{2,}/g, '/');
+    return value;
+}
+function toIsoTimestamp(input) {
+    if (!input) {
+        return new Date().toISOString();
+    }
+    return typeof input === 'string' ? input : input.toISOString();
+}
+function urlJoin(baseUrl, ...parts) {
+    const normalizedBase = normalizeBaseUrl(baseUrl);
+    const normalizedParts = parts
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0)
+        .map((part) => part.replace(/^\/+|\/+$/g, ''))
+        .filter((part) => part.length > 0);
+    if (normalizedParts.length === 0) {
+        return normalizedBase;
+    }
+    return `${normalizedBase}/${normalizedParts.join('/')}`;
+}
+//# sourceMappingURL=format.cjs.map

package/dist/cjs/format.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "format.cjs",
+  "sourceRoot": "",
+  "sources": [
+    "../../src/format.ts"
+  ],
+  "names": [],
+  "mappings": ";;;AAGA,8BAGC;AAED,4CAEC;AAED,0CASC;AAED,sCASC;AAED,wCAMC;AAED,0BAaC;AAvDY,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAC1B,QAAA,WAAW,GAAG,GAAG,CAAC;AAE/B,SAAgB,SAAS,CAAC,KAAa;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,4BAAoB,CAAC;IACjG,OAAO,mBAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,eAAe,CAAC,MAAc;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IAC9D,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,KAAK,IAAI,GAAG,CAAC;AACtB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IAC9D,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,cAAc,CAAC,KAAqB;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;AACjE,CAAC;AAED,SAAgB,OAAO,CAAC,OAAe,EAAE,GAAG,KAAe;IACzD,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,KAAK;SAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;SAC7C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,cAAc,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1D,CAAC"
+}

package/dist/cjs/index.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentBanner = exports.printAgentBanner = void 0;
+var banner_1 = require("./banner");
+Object.defineProperty(exports, "printAgentBanner", { enumerable: true, get: function () { return banner_1.printAgentBanner; } });
+Object.defineProperty(exports, "renderAgentBanner", { enumerable: true, get: function () { return banner_1.renderAgentBanner; } });
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "index.cjs",
+  "sourceRoot": "",
+  "sources": [
+    "../../src/index.ts"
+  ],
+  "names": [],
+  "mappings": ";;;AAAA,mCAA+D;AAAtD,0GAAA,gBAAgB,OAAA;AAAE,2GAAA,iBAAiB,OAAA"
+}

package/dist/cjs/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/cjs/types.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "types.cjs",
+  "sourceRoot": "",
+  "sources": [
+    "../../src/types.ts"
+  ],
+  "names": [],
+  "mappings": ""
+}

package/dist/esm/banner.js

@@ -0,0 +1,66 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DEFAULT_BANNER_WIDTH, getBorder, normalizeBaseUrl, normalizePath, normalizePrefix, toIsoTimestamp, urlJoin, } from './format';
+function resolveVersion(packageJsonPath, override) {
+    if (override) {
+        return override;
+    }
+    try {
+        const raw = fs.readFileSync(packageJsonPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.version === 'string' && parsed.version.trim()) {
+            return parsed.version.trim();
+        }
+    }
+    catch {
+        return '0.0.0';
+    }
+    return '0.0.0';
+}
+export function renderAgentBanner(config) {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const prefix = normalizePrefix(config.prefix);
+    const docsPath = normalizePath(config.docsPath ?? '/docs');
+    const healthPath = normalizePath(config.healthPath ?? '/health');
+    const endpoints = config.endpoints ?? [];
+    const packageJsonPath = config.packageJsonPath ?? path.join(process.cwd(), 'package.json');
+    const version = resolveVersion(packageJsonPath, config.version);
+    const environment = config.environment ?? process.env.NODE_ENV ?? 'development';
+    const timestamp = toIsoTimestamp(config.timestamp);
+    const width = config.width ?? DEFAULT_BANNER_WIDTH;
+    const border = getBorder(width);
+    const emoji = config.emoji ?? true;
+    const rocket = emoji ? '🚀 ' : '';
+    const server = emoji ? '📡 ' : '';
+    const docs = emoji ? '📚 ' : '';
+    const health = emoji ? '🏥 ' : '';
+    const endpointsLabel = emoji ? '📝 ' : '';
+    const docsUrl = urlJoin(baseUrl, prefix, docsPath);
+    const healthUrl = urlJoin(baseUrl, prefix, healthPath);
+    const endpointLines = endpoints.length
+        ? endpoints.map((endpoint) => {
+            const endpointPath = normalizePath(endpoint.path);
+            const endpointUrl = urlJoin(baseUrl, prefix, endpointPath);
+            return `    - ${endpoint.method} - ${endpoint.description} - ${endpointUrl}`;
+        })
+        : ['    - (none)'];
+    const lines = [
+        border,
+        `${rocket}${config.agentName} - ${version}`,
+        border,
+        `${server}Server running on: ${baseUrl}`,
+        `${docs}API Documentation: ${docsUrl}`,
+        `${health}Health Check: ${healthUrl}`,
+        `${endpointsLabel}Endpoints:`,
+        ...endpointLines,
+        border,
+        `Environment: ${environment}`,
+        `Timestamp: ${timestamp}`,
+        border,
+    ];
+    return `${lines.join('\n')}\n`;
+}
+export function printAgentBanner(config, logger = console) {
+    logger.log(renderAgentBanner(config));
+}
+//# sourceMappingURL=banner.js.map

package/dist/esm/banner.js.map

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

package/dist/esm/format.js

@@ -0,0 +1,46 @@
+export const DEFAULT_BANNER_WIDTH = 48;
+export const BORDER_CHAR = '═';
+export function getBorder(width) {
+    const safeWidth = Number.isFinite(width) && width > 0 ? Math.floor(width) : DEFAULT_BANNER_WIDTH;
+    return BORDER_CHAR.repeat(safeWidth);
+}
+export function normalizeBaseUrl(baseUrl) {
+    return baseUrl.trim().replace(/\/+$/, '');
+}
+export function normalizePrefix(prefix) {
+    const trimmed = prefix.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/';
+    }
+    let value = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    value = value.replace(/\/+$/, '');
+    return value || '/';
+}
+export function normalizePath(pathValue) {
+    const trimmed = pathValue.trim();
+    if (!trimmed || trimmed === '/') {
+        return '/';
+    }
+    let value = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    value = value.replace(/\/{2,}/g, '/');
+    return value;
+}
+export function toIsoTimestamp(input) {
+    if (!input) {
+        return new Date().toISOString();
+    }
+    return typeof input === 'string' ? input : input.toISOString();
+}
+export function urlJoin(baseUrl, ...parts) {
+    const normalizedBase = normalizeBaseUrl(baseUrl);
+    const normalizedParts = parts
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0)
+        .map((part) => part.replace(/^\/+|\/+$/g, ''))
+        .filter((part) => part.length > 0);
+    if (normalizedParts.length === 0) {
+        return normalizedBase;
+    }
+    return `${normalizedBase}/${normalizedParts.join('/')}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/esm/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAE/B,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACjG,OAAO,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IAC9D,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,KAAK,IAAI,GAAG,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IAC9D,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,GAAG,KAAe;IACzD,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,KAAK;SAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;SAC7C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,cAAc,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { printAgentBanner, renderAgentBanner } from './banner';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/types/banner.d.ts

@@ -0,0 +1,4 @@
+import type { AgentBannerConfig } from './types';
+export declare function renderAgentBanner(config: AgentBannerConfig): string;
+export declare function printAgentBanner(config: AgentBannerConfig, logger?: Pick<Console, 'log'>): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/types/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/banner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA6BjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA+CnE;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,GAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAW,GACrC,IAAI,CAEN"}

package/dist/types/format.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_BANNER_WIDTH = 48;
+export declare const BORDER_CHAR = "\u2550";
+export declare function getBorder(width: number): string;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+export declare function normalizePrefix(prefix: string): string;
+export declare function normalizePath(pathValue: string): string;
+export declare function toIsoTimestamp(input?: string | Date): string;
+export declare function urlJoin(baseUrl: string, ...parts: string[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/types/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,WAAW,WAAM,CAAC;AAE/B,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM5D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAanE"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { printAgentBanner, renderAgentBanner } from './banner';
+export type { AgentBannerConfig, AgentEndpoint, HttpMethod } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,21 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+export interface AgentEndpoint {
+    method: HttpMethod;
+    path: string;
+    description: string;
+}
+export interface AgentBannerConfig {
+    agentName: string;
+    packageJsonPath?: string;
+    version?: string;
+    baseUrl: string;
+    prefix: string;
+    docsPath?: string;
+    healthPath?: string;
+    endpoints?: AgentEndpoint[];
+    environment?: string;
+    timestamp?: string | Date;
+    width?: number;
+    emoji?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "agent-banner-library",
+  "version": "0.0.1",
+  "description": "Standardized startup banner logger for REST API agents.",
+  "keywords": [
+    "agent",
+    "banner",
+    "logger",
+    "startup",
+    "rest",
+    "api"
+  ],
+  "author": "Auronforge",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/auronforge/agent-banner-library.git",
+    "directory": "packages/agent-banner"
+  },
+  "bugs": {
+    "url": "https://github.com/auronforge/agent-banner-library/issues"
+  },
+  "homepage": "https://github.com/auronforge/agent-banner-library#readme",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "npm run build:types && npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.build.esm.json",
+    "build:cjs": "tsc -p tsconfig.build.cjs.json && node scripts/rename-cjs.js",
+    "build:types": "tsc -p tsconfig.build.types.json",
+    "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write",
+    "format:check": "prettier --check",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "npx tsx scripts/dev.ts",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "release": "standard-version",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky install"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.3.0",
+    "@commitlint/config-conventional": "^19.3.0",
+    "@types/jest": "^29.5.12",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "eslint": "^9.10.0",
+    "eslint-config-prettier": "^9.1.0",
+    "husky": "^9.1.4",
+    "jest": "^29.7.0",
+    "lint-staged": "^15.2.9",
+    "prettier": "^3.3.3",
+    "standard-version": "^9.5.0",
+    "ts-jest": "^29.2.5",
+    "tslib": "^2.6.3",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  }
+}