statelog-client 0.0.28

package/README.md

@@ -0,0 +1,7 @@
+# statelog-client
+
+A client for statelog.
+
+```bash
+pnpm i egonSchiele/statelog-client
+```

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+export type JSONEdge = {
+    type: "regular";
+    to: string;
+} | {
+    type: "conditional";
+    adjacentNodes: readonly string[];
+};
+export declare class StatelogClient {
+    private host;
+    private debugMode;
+    private tid;
+    constructor({ host, tid, debugMode, }: {
+        host: string;
+        tid?: string;
+        debugMode?: boolean;
+    });
+    debug(message: string, data: any): void;
+    graph({ nodes, edges, startNode, }: {
+        nodes: string[];
+        edges: Record<string, JSONEdge>;
+        startNode?: string;
+    }): void;
+    enterNode({ nodeId, data }: {
+        nodeId: string;
+        data: any;
+    }): void;
+    exitNode({ nodeId, data, timeTaken, }: {
+        nodeId: string;
+        data: any;
+        timeTaken?: number;
+    }): void;
+    beforeHook({ nodeId, startData, endData, timeTaken, }: {
+        nodeId: string;
+        startData: any;
+        endData: any;
+        timeTaken?: number;
+    }): void;
+    afterHook({ nodeId, startData, endData, timeTaken, }: {
+        nodeId: string;
+        startData: any;
+        endData: any;
+        timeTaken?: number;
+    }): void;
+    followEdge({ fromNodeId, toNodeId, isConditionalEdge, data, }: {
+        fromNodeId: string;
+        toNodeId: string;
+        isConditionalEdge: boolean;
+        data: any;
+    }): void;
+    promptCompletion({ messages, completion, model, timeTaken, }: {
+        messages: any[];
+        completion: any;
+        model?: string;
+        timeTaken?: number;
+    }): void;
+    toolCall({ toolName, args, output, model, timeTaken, }: {
+        toolName: string;
+        args: any;
+        output: any;
+        model?: string;
+        timeTaken?: number;
+    }): void;
+    post(body: Record<string, any>): void;
+}

package/dist/index.js

@@ -0,0 +1,104 @@
+import { nanoid } from "nanoid";
+export class StatelogClient {
+    constructor({ host, tid, debugMode, }) {
+        this.host = host;
+        this.debugMode = debugMode || false;
+        this.tid = tid || nanoid();
+        if (this.debugMode)
+            console.log(`Statelog client initialized with host: ${host} and TID: ${this.tid}`);
+    }
+    debug(message, data) {
+        this.post({
+            type: "debug",
+            message: message,
+            data,
+        });
+    }
+    graph({ nodes, edges, startNode, }) {
+        this.post({
+            type: "graph",
+            nodes,
+            edges,
+            startNode,
+        });
+    }
+    enterNode({ nodeId, data }) {
+        this.post({
+            type: "enterNode",
+            nodeId,
+            data,
+        });
+    }
+    exitNode({ nodeId, data, timeTaken, }) {
+        this.post({
+            type: "exitNode",
+            nodeId,
+            data,
+            timeTaken,
+        });
+    }
+    beforeHook({ nodeId, startData, endData, timeTaken, }) {
+        this.post({
+            type: "beforeHook",
+            nodeId,
+            startData,
+            endData,
+            timeTaken,
+        });
+    }
+    afterHook({ nodeId, startData, endData, timeTaken, }) {
+        this.post({
+            type: "afterHook",
+            nodeId,
+            startData,
+            endData,
+            timeTaken,
+        });
+    }
+    followEdge({ fromNodeId, toNodeId, isConditionalEdge, data, }) {
+        this.post({
+            type: "followEdge",
+            edgeId: `${fromNodeId}->${toNodeId}`,
+            fromNodeId,
+            toNodeId,
+            isConditionalEdge,
+            data,
+        });
+    }
+    promptCompletion({ messages, completion, model, timeTaken, }) {
+        this.post({
+            type: "promptCompletion",
+            messages,
+            completion,
+            model,
+            timeTaken,
+        });
+    }
+    toolCall({ toolName, args, output, model, timeTaken, }) {
+        this.post({
+            type: "toolCall",
+            toolName,
+            args,
+            output,
+            model,
+            timeTaken,
+        });
+    }
+    post(body) {
+        const fullUrl = new URL("/api/logs", this.host);
+        const url = fullUrl.toString();
+        fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                tid: this.tid,
+                data: Object.assign(Object.assign({}, body), { timeStamp: new Date().toISOString() }),
+            }),
+        }).catch((err) => {
+            if (this.debugMode)
+                console.error("Failed to send statelog:", err);
+        });
+    }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "statelog-client",
+  "version": "0.0.28",
+  "description": "A client for statelog, a logging app",
+  "homepage": "https://github.com/egonSchiele/statelog-client",
+  "scripts": {
+    "test": "vitest",
+    "test:tsc": "tsc -p tests/tsconfig.json",
+    "coverage": "vitest --coverage",
+    "build": "rm -rf dist && tsc",
+    "start": "cd dist && node index.js"
+  },
+  "files": [
+    "./dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "statelog",
+    "client"
+  ],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^20.19.27",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.1"
+  },
+  "dependencies": {
+    "nanoid": "^5.1.6"
+  }
+}