@augno/sdk-mcp 0.10.0

package/instructions.mjs

@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import fs from 'fs/promises';
+import { getLogger } from "./logger.mjs";
+const INSTRUCTIONS_CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes
+const instructionsCache = new Map();
+export async function getInstructions({ stainlessApiKey, customInstructionsPath, }) {
+    const now = Date.now();
+    const cacheKey = customInstructionsPath ?? stainlessApiKey ?? '';
+    const cached = instructionsCache.get(cacheKey);
+    if (cached && now - cached.fetchedAt <= INSTRUCTIONS_CACHE_TTL_MS) {
+        return cached.fetchedInstructions;
+    }
+    // Evict stale entries so the cache doesn't grow unboundedly.
+    for (const [key, entry] of instructionsCache) {
+        if (now - entry.fetchedAt > INSTRUCTIONS_CACHE_TTL_MS) {
+            instructionsCache.delete(key);
+        }
+    }
+    let fetchedInstructions;
+    if (customInstructionsPath) {
+        fetchedInstructions = await fetchLatestInstructionsFromFile(customInstructionsPath);
+    }
+    else {
+        fetchedInstructions =
+            '\n  This is the augno MCP server.\n\n  Available tools:\n  - search_docs: Search SDK documentation to find the right methods and parameters.\n  - execute: Run TypeScript code against a pre-authenticated SDK client. Define an async run(client) function.\n\n  Workflow:\n  - If unsure about the API, call search_docs first.\n  - Write complete solutions in a single execute call when possible. For large datasets, use API filters to narrow results or paginate within a single execute block.\n  - If execute returns an error, read the error and fix your code rather than retrying the same approach.\n  - Variables do not persist between execute calls. Return or log all data you need.\n  - Individual HTTP requests to the API have a 30-second timeout. If a request times out, try a smaller query or add filters.\n  - Code execution has a total timeout of approximately 5 minutes. If your code times out, simplify it or break it into smaller steps.\n  ';
+        fetchedInstructions +=
+            '\nThis MCP server wraps the Augno API (production management for SMB\nmanufacturers). Use the code tool to call the API by writing TypeScript\nagainst the Augno SDK. Authenticate with an Augno API key as a Bearer\ntoken; set the active account with the Augno-Account header when\noperating across multiple accounts.\n';
+    }
+    instructionsCache.set(cacheKey, { fetchedInstructions, fetchedAt: now });
+    return fetchedInstructions;
+}
+async function fetchLatestInstructionsFromFile(path) {
+    try {
+        return await fs.readFile(path, 'utf-8');
+    }
+    catch (error) {
+        getLogger().error({ error, path }, 'Error fetching instructions from file');
+        throw error;
+    }
+}
+//# sourceMappingURL=instructions.mjs.map

package/instructions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.mjs","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,aAAa;OACrB,EAAE,SAAS,EAAE;AAEpB,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB;YACjB,s7BAAs7B,CAAC;QACz7B,mBAAmB;YACjB,+TAA+T,CAAC;IACpU,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/logger.d.mts

@@ -0,0 +1,7 @@
+import { type Level, type Logger } from 'pino';
+export declare function configureLogger({ level, pretty: usePretty }: {
+    level: Level;
+    pretty: boolean;
+}): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.mts.map

package/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"OAEO,EAAQ,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM;AAKpD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAarG;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}

package/logger.d.ts

@@ -0,0 +1,7 @@
+import { type Level, type Logger } from 'pino';
+export declare function configureLogger({ level, pretty: usePretty }: {
+    level: Level;
+    pretty: boolean;
+}): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"OAEO,EAAQ,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM;AAKpD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAarG;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}

package/logger.js

@@ -0,0 +1,29 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureLogger = configureLogger;
+exports.getLogger = getLogger;
+const pino_1 = require("pino");
+const pino_pretty_1 = __importDefault(require("pino-pretty"));
+let _logger;
+function configureLogger({ level, pretty: usePretty }) {
+    _logger = (0, pino_1.pino)({
+        level,
+        timestamp: pino_1.pino.stdTimeFunctions.isoTime,
+        formatters: {
+            level(label) {
+                return { level: label };
+            },
+        },
+    }, usePretty ? (0, pino_pretty_1.default)({ colorize: true, levelFirst: true, destination: 2 }) : process.stderr);
+}
+function getLogger() {
+    if (!_logger) {
+        throw new Error('Logger has not been configured. Call configureLogger() before using the logger.');
+    }
+    return _logger;
+}
+//# sourceMappingURL=logger.js.map

package/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;AAOtF,0CAaC;AAED,8BAKC;AAzBD,+BAAqD;AACrD,8DAAiC;AAEjC,IAAI,OAA2B,CAAC;AAEhC,SAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAqC;IAC7F,OAAO,GAAG,IAAA,WAAI,EACZ;QACE,KAAK;QACL,SAAS,EAAE,WAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,UAAU,EAAE;YACV,KAAK,CAAC,KAAK;gBACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1B,CAAC;SACF;KACF,EACD,SAAS,CAAC,CAAC,CAAC,IAAA,qBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAC1F,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/logger.mjs

@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { pino } from 'pino';
+import pretty from 'pino-pretty';
+let _logger;
+export function configureLogger({ level, pretty: usePretty }) {
+    _logger = pino({
+        level,
+        timestamp: pino.stdTimeFunctions.isoTime,
+        formatters: {
+            level(label) {
+                return { level: label };
+            },
+        },
+    }, usePretty ? pretty({ colorize: true, levelFirst: true, destination: 2 }) : process.stderr);
+}
+export function getLogger() {
+    if (!_logger) {
+        throw new Error('Logger has not been configured. Call configureLogger() before using the logger.');
+    }
+    return _logger;
+}
+//# sourceMappingURL=logger.mjs.map

package/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,IAAI,EAA2B,MAAM,MAAM;OAC7C,MAAM,MAAM,aAAa;AAEhC,IAAI,OAA2B,CAAC;AAEhC,MAAM,UAAU,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAqC;IAC7F,OAAO,GAAG,IAAI,CACZ;QACE,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,UAAU,EAAE;YACV,KAAK,CAAC,KAAK;gBACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1B,CAAC;SACF;KACF,EACD,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAC1F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/methods.d.mts

@@ -0,0 +1,10 @@
+import { McpOptions } from "./options.mjs";
+export type SdkMethod = {
+    clientCallName: string;
+    fullyQualifiedName: string;
+    httpMethod?: 'get' | 'post' | 'put' | 'patch' | 'delete' | 'query';
+    httpPath?: string;
+};
+export declare const sdkMethods: SdkMethod[];
+export declare function blockedMethodsForCodeTool(options: McpOptions | undefined): SdkMethod[] | undefined;
+//# sourceMappingURL=methods.d.mts.map

package/methods.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.mts","sourceRoot":"","sources":["src/methods.ts"],"names":[],"mappings":"OAEO,EAAE,UAAU,EAAE;AAErB,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,SAAS,EAyyCjC,CAAC;AA+DF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,SAAS,CAUlG"}

package/methods.d.ts

@@ -0,0 +1,10 @@
+import { McpOptions } from "./options.js";
+export type SdkMethod = {
+    clientCallName: string;
+    fullyQualifiedName: string;
+    httpMethod?: 'get' | 'post' | 'put' | 'patch' | 'delete' | 'query';
+    httpPath?: string;
+};
+export declare const sdkMethods: SdkMethod[];
+export declare function blockedMethodsForCodeTool(options: McpOptions | undefined): SdkMethod[] | undefined;
+//# sourceMappingURL=methods.d.ts.map

package/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["src/methods.ts"],"names":[],"mappings":"OAEO,EAAE,UAAU,EAAE;AAErB,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,SAAS,EAyyCjC,CAAC;AA+DF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,SAAS,CAUlG"}