@drdoc-com/pi-drdoc 1.0.3 → 1.0.5

package/README.md

@@ -1,8 +1,8 @@
-# Pi Plugin for Dr.DOC DMS
+# Pi Package for Dr.DOC® ECM/DMS
 
-An integration plugin Package for the **Pi Agent** (`pi.dev`) ecosystem to interact seamlessly with the [**Dr.DOC Document Management System** \(DMS/ECM\)](https://drdoc.com/node/de/products/web). 
+An integration package/plugin/extension for the **Pi Agent** (`pi.dev`) ecosystem to interact seamlessly with the [**Dr.DOC® Document Management System** \(ECM/DMS\)](https://drdoc.com/node/de/products/web). 
 
-This plugin allows the Pi Agent to query Dr.DOC archives, fetch document blobs, store files locally, generate direct web links, and display inline document previews.
+This extension package allows the Pi Agent to query Dr.DOC archives, fetch document blobs, store files locally, generate direct web links, and display inline document previews.
 
 ---
 
@@ -11,14 +11,18 @@ This plugin allows the Pi Agent to query Dr.DOC archives, fetch document blobs,
 The integration between Pi Agent and Dr.DOC is split into two primary operational directions:
 
 ### 1. Pi → Dr.DOC (This Plugin)
-This plugin enables the **Pi Agent** to make outgoing API calls to **Dr.DOC**. The agent uses these tool functions to search archives, retrieve documents, save them locally, and process binary/image data.
+*This* plugin enables the **Pi Agent** to make outgoing API calls to **Dr.DOC**. The agent uses these tool functions to search archives, retrieve documents, save them locally, and process binary/image data.
+
+* **GitHub Repository:** [github.com/drdoc-com/pi-drdoc](https://github.com/drdoc-com/pi-drdoc)
+* **npm Package:** [npmjs.com/package/@drdoc-com/pi-drdoc](https://www.npmjs.com/package/@drdoc-com/pi-drdoc)
+* **Pi Package Registry:** [pi.dev/packages/@drdoc-com/pi-drdoc](https://pi.dev/packages/@drdoc-com/pi-drdoc)
 
 ### 2. Dr.DOC → Pi (OpenAI API Wrapper)
 To allow **Dr.DOC** (or external tools) to send requests to Pi using the standard OpenAI API format, the `@drdoc-com/pi-openai-api-wrapper` package can be used.
 
 * **GitHub Repository:** [github.com/drdoc-com/pi-openai-api-wrapper](https://github.com/drdoc-com/pi-openai-api-wrapper)
-* **Pi Package Registry:** [pi.dev/packages/@drdoc-com/pi-openai-api-wrapper](https://pi.dev/packages/@drdoc-com/pi-openai-api-wrapper)
 * **npm Package:** [npmjs.com/package/@drdoc-com/pi-openai-api-wrapper](https://www.npmjs.com/package/@drdoc-com/pi-openai-api-wrapper)
+* **Pi Package Registry:** [pi.dev/packages/@drdoc-com/pi-openai-api-wrapper](https://pi.dev/packages/@drdoc-com/pi-openai-api-wrapper)
 
 ---
 
@@ -74,7 +78,7 @@ Suche im Dr.DOC Archiv "rec" alle Rechnungen von Firma Amazon aus diesem Jahr.
 
 ## Configuration
 
-The plugin utilizes configuration options supplied by the Dr.DOC client or environment variables.
+The extension package utilizes configuration options supplied by the Dr.DOC client or environment variables.
 
 ### Environment Variables
 
@@ -83,8 +87,10 @@ The plugin utilizes configuration options supplied by the Dr.DOC client or envir
 | `DRDOC_BASE_URL` | Base URL of the Dr.DOC instance | `https://drdoc.com` |
 | `DRDOC_CONFIG_DIR` (alt. `PI_CONFIG_DIR`) | Custom directory for config files | `~/.pi/agent` |
 | `DRDOC_DOWNLOAD_DIR` | Custom directory for downloaded files | `~/.drdoc/downloads` |
-| `DRDOC_IGNORE_SSL` | Ignore TLS/SSL Errors (Set `NODE_TLS_REJECT_UNAUTHORIZED=0`) | `` |
-| `DRDOC_DEBUG` | Enable Debugging | `` |
+| `DRDOC_IGNORE_SSL` | Ignore TLS/SSL Errors (Set `NODE_TLS_REJECT_UNAUTHORIZED=0`) |  |
+| `DRDOC_AI_FS_<ArchiveName>` | Dr.DOC *Archive specific* (upper-case) IMPORT_ASCII FieldSelection Name for Field Descriptions. | `DRDOC_AI_FS` |
+| `DRDOC_AI_FS` | Dr.DOC IMPORT_ASCII FieldSelection Name for Field Descriptions. | `STD_AI_INVOICE_IN`, `DD_FIELD_DESC`, `STD_FIELD_DESC` |
+| `DRDOC_DEBUG` | Enable Debugging |  |
 
 ---
 
@@ -99,7 +105,8 @@ The plugin utilizes configuration options supplied by the Dr.DOC client or envir
 ## License
 
 This project is licensed under the Apache License 2.0.
-Dr.DOC DMS is licensed is under proprietary License.
+
+Dr.DOC® ECM/DMS is licensed is under proprietary License.
 
 ---
 

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@drdoc-com/pi-drdoc",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Dr.DOC DMS Integration Package for PI Agent",
   "type": "module",
   "license": "Apache License 2.0",
   "keywords": [
     "pi-package",
     "pi-agent",
-    "drdoc",
     "rest-api",
     "skill",
-    "dms",
-    "Dr.DOC"
+    "drdoc",
+    "Dr.DOC",
+    "dms"
   ],
   "private": false,
   "pi": {
@@ -31,7 +31,7 @@
   "author": "Dr.DOC GmbH, DE-80802 Munich",
   "devDependencies": {
     "typescript": "^7.0.2",
-    "@types/node": "^26.2.0"
+    "@types/node": "^24.0.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*"

package/src/drdoc-client.ts

@@ -163,7 +163,8 @@ export class DrDocClient {
     try {
       const dataToSave = JSON.stringify(this.config, null, 2);
       fs.writeFileSync(this.storageFilePath, dataToSave, "utf-8");
-      msgLog('DD Anmeldedaten wurden gespeichert unter: ', this.storageFilePath);
+      if (process.env.DRDOC_DEBUG)
+        msgLog('Dr.DOC Anmeldedaten wurden gespeichert unter: ', this.storageFilePath);
     } catch (error) {
       throw new Error(`Fehler beim Speichern der Anmeldedaten: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -192,8 +193,11 @@ export class DrDocClient {
     if (setCookie) {
       const match = setCookie.match(/uid=([^;]+)/);
       if (match) {
+        const oldCookieValue = this.config.sessionCookie;
         this.config.sessionCookie = `uid=${match[1]}`;
-        // this.saveCredentials(this.config);
+        // bei Cookie Änderung, Cookie uid explizit abspeichern
+        if (oldCookieValue != this.config.sessionCookie)
+          this.saveCredentials();
       }
     }
   }
@@ -330,11 +334,13 @@ export class DrDocClient {
       // Dauerhaftes Speichern der gesamten DrDocConfig nach erfolgreichem Login
       this.saveCredentials();
 
-      msgLog('DD: Sign in OK:', this.config);
+      if (process.env.DRDOC_DEBUG)
+        msgLog('DD: Sign in OK: ', JSON.stringify(this.config));
     }
     else {
-
-      console.warn('DD: Sign in ERR:', this.config);
+      //if (process.env.DRDOC_DEBUG)
+      if (process.env.DRDOC_DEBUG)
+        msgLog('DD: Sign in ERROR: ' + JSON.stringify(this.config));
     }
 
     return response;
@@ -349,11 +355,14 @@ export class DrDocClient {
 
     // Überprüfung auf erfolgreiche Anmeldung
     if (response && !response.HasError) {
-      msgLog('DD: State OK:', this.config);
+      if (process.env.DRDOC_DEBUG)
+        msgLog('Dr.DOC: State OK:', this.config);
       return true;
     }
     else {
-      msgError('DD: State ERR:', this.config);
+      msgError('Bitte erneut anmelden mit Slash Command `/drdoc_login`');
+      if (process.env.DRDOC_DEBUG)
+        msgLog('Dr.DOC: State ERROR: ' + JSON.stringify(this.config));
       return false;
     }
   }

package/src/index.ts

@@ -17,7 +17,7 @@ export default function (pi: any): void {
 
   // Login
   pi.registerCommand("drdoc_login", {
-    description: "Benutzer anmelden in Dr.DOC über die REST API und speichert die Session.",
+    description: "Benutzer anmelden in Dr.DOC über die REST API und speichert die Session: `/drdoc_login <baseUrl> <username> <password> <totp> <ignoreSSL:1,0>`",
     handler: async (args: string, ctx: any) => {
       // Entfernen leerer Strings nach dem String-Split
       const parts = args.trim().split(/\s+/); //.filter(Boolean);
@@ -34,18 +34,18 @@ export default function (pi: any): void {
       try {
         //initializeDrDocClient({ baseUrl, username, password, totp, ignoreSSL });
         //const client = new DrDocClient({ baseUrl, username, password, totp, ignoreSSL });
-        const client = await getClient({ baseUrl, username, password, totp, ignoreSSL: (ignoreSSL == '1' || ignoreSSL == 'true') });
+        const client = await getClient({ baseUrl, username, password, totp, ignoreSSL: (ignoreSSL == '1' || ignoreSSL == 'true') }, true);
         if (process.env.DRDOC_DEBUG)
           msgLog('Client: ', client);
 
-        const response = await client.signin(username, password, totp);
+        /*const response = await client.signin(username, password, totp);
 
         if (response.HasError) {
           msgError(`Anmeldung fehlgeschlagen: ${response.Error?.Message}`);
           return;
         }
 
-        msgInfo("Erfolgreich an Dr.DOC angemeldet. Die Session ist aktiv.");
+        msgInfo("Erfolgreich an Dr.DOC angemeldet. Die Session ist aktiv.");*/
       } catch (err: any) {
         msgError(`Fehler bei der Verbindung: ${err.message}`);
       }

package/src/tools.ts

@@ -11,13 +11,27 @@ let clientInstance: DrDocClient | null = null;
  */
 export async function getClient(config: DrDocConfig = {} as DrDocConfig, force: Boolean = false): Promise<DrDocClient> {
   if (!clientInstance || force) {
-    msgInfo('getClient: init instance');
+    if (process.env.DRDOC_DEBUG)
+      msgInfo('getClient: init instance');
     clientInstance = new DrDocClient(config);
+
     // Verbindung testen
-    if (await clientInstance.state())
-      msgInfo('getClient: state ok');
+    if (await clientInstance.state()) {
+      msgInfo('Bereits in Dr.DOC angemeldet. Die Session ist aktiv.');
+    }
     else {
-      throw new Error("getClient: DrDocClient ist nicht initialisiert. Bitte vorher den Befehl /drdoc_login ausführen.");
+      const response = await clientInstance.signin(config.username, config.password, config.totp);
+      if (response.HasError)
+        throw new Error("getClient: DrDocClient ist nicht initialisiert. Bitte vorher den Befehl /drdoc_login ausführen.");
+
+      msgInfo("Erfolgreich an Dr.DOC angemeldet. Die Session ist aktiv.");
+
+      // Verbindung testen
+      /*if (await clientInstance.state())
+        msgInfo('getClient: state ok');
+      else {
+
+      }*/
     }
   }
   return clientInstance;
@@ -138,8 +152,10 @@ export const drdocTools = [
       if (process.env.DRDOC_DEBUG)
         msgLog('drdoc_properties_fields:', args);
       return safeExecuteClient(["archive"], args, async (client, safeArgs) => {
-        const defNameArray = ['STD_AI_INVOICE_IN', 'DD_FIELD_DESC', 'STD_FIELD_DESC'];
+        const defNameArray = [process.env['DRDOC_AI_FS_' + safeArgs.archive.toUpperCase()], process.env.DRDOC_AI_FS, 'STD_AI_INVOICE_IN', 'DD_FIELD_DESC', 'STD_FIELD_DESC'];
         for (let defName of defNameArray) {
+          if (!defName)
+            continue;
           const fs = await client.getFieldSelection(safeArgs.archive, "IMPORT_ASCII", defName);
           if (process.env.DRDOC_DEBUG)
             msgLog('props:', fs);
@@ -170,29 +186,31 @@ Suchoperatoren:
 - ! als logischer NOT Operator als Prefix, muss dem Suchbegriff vorangestellt werden.
 - !* für leere Felder
 - <-> für Datumsbereich, Zeitraum, Bereichssuche, Zahlenbereich; A<->B von A bis einschließlich B; Format für Datumsbereich: DD.MM.YYYY<->DD.MM.YYYY z.B. 01.07.2024<->31.07.2024.
-Beispiele für Suchoperatoren:
-- *TEXT* für trunkierte/Substring Suche nach TEXT (Feldwert enthält TEXT), MUSS zwingend bei unklaren/ungenauen/unspezifischen Eingaben verwendet werden!
-- !*TEXT* für Feldwert enthält TEXT nicht
-- !* für leeren, nicht gefüllte Feldwerte
-- !TEXT für alle Feldwerte, abgesehen von TEXT bzw. alles bis auf TEXT.
-- !A&B für exakte Suche nach B jedoch ohne A
-- "A|B" (Pippe) für exakte Suche nach A oder B
-- !*A*&*B* für Suche nach enthält (Substring) B aber enthält kein A
-- 01.01.2020<->31.12.2020 für Datumssuchbereichs-Suche (Bereichssuche) vom 01.01.2020 bis einschließlich 31.12.2020 (1 Jahr)
-- 01.07.2024<->31.07.2024 für Datumssuchbereichs-Suche (Bereichssuche) vom 01.07.2024 bis einschließlich 31.07.2024 für den Monat Juli 2024 (1 Monat)
 Datumsformat: DD.MM.YYYY
 Zahlenformat: 0.00
 Variablen:
-- %DY% Variable für Datumsbereich im aktuellen/diesen Jahr
-- %DMY% Variable für Datumsbereich im aktuellen/diesen Monat
-- %DWY% Variable für Datumsbereich in der aktuellen/diesen Woche (7 Tage)
+- %DY% Variable für Datumsbereich im *aktuellen Jahr*
+- %DMY% Variable für Datumsbereich im *aktuellen Monat*
+- %DWY% Variable für Datumsbereich in der *aktuellen Woche* (7 Tage)
 - %B% Variable für angemeldeten Benutzer
 - %D% Variable für aktuelles Datum (heutiger Tag)
 - %D-1% Variable für gestriges Datum bzw. gestern
 - %D-2% Variable für vorgestern
 - %D+1% Variable für morgiges Datum bzw. morgen
 - %D+2% Variable für übermorgen
-Beispiel: Filter für alle Eingangsrechnungen im Zeitraum Juli 2024 (01.07.2024 bis einschließlich 31.07.2024) von Firma Amazon:
+Beispiele:
+- *TEXT* für trunkierte/Substring Suche nach TEXT (Feldwert enthält TEXT), MUSS zwingend bei unklaren/ungenauen/unspezifischen Eingaben verwendet werden!
+- !*TEXT* für Feldwert enthält TEXT nicht
+- !* für leeren, nicht gefüllte Feldwerte
+- !TEXT für alle Feldwerte, abgesehen von TEXT bzw. alles bis auf TEXT.
+- !A&B für exakte Suche nach B jedoch ohne A
+- "A|B" (Pippe) für exakte Suche nach A oder B
+- !*A*&*B* für Suche nach enthält (Substring) B aber enthält kein A
+- 01.01.2020<->31.12.2020 für Datumssuchbereichs-Suche (Bereichssuche) vom 01.01.2020 bis einschließlich 31.12.2020 (1 Jahr)
+- 01.07.2024<->31.07.2024 für Datumssuchbereichs-Suche (Bereichssuche) vom 01.07.2024 bis einschließlich 31.07.2024 für den Monat Juli 2024 (1 Monat)
+- %DY% für Datumssuchbereichs-Suche (Bereichssuche) im aktuellen Jahr, z.B. vom 01.01.2020 bis einschließlich 31.12.2020 (1 Jahr)
+- %DMY% für Datumssuchbereichs-Suche (Bereichssuche) im aktuellen Monat, z.B. vom 01.01.2020 bis einschließlich 31.01.2020 (1 Monat)
+Text-Beispiel: Filter für alle Eingangsrechnungen im Zeitraum Juli 2024 (01.07.2024 bis einschließlich 31.07.2024) von Firma Amazon:
 { date: "01.07.2024<->31.07.2024", c_company: "*Amazon*", inout: "0", type: "Rechnung" }
     `,
     parameters: {
@@ -404,4 +422,4 @@ Datumsformat: DD.MM.YYYY
       });
     },
   },
-];
+];