@tpmjs/official-org-chart-format 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 TPMJS
+
+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/dist/index.d.ts

@@ -0,0 +1,55 @@
+import * as ai from 'ai';
+
+/**
+ * Org Chart Format Tool for TPMJS
+ * Formats organizational hierarchy data into structured org chart representation
+ */
+/**
+ * Employee input data
+ */
+interface EmployeeInput {
+    id: string;
+    name: string;
+    title: string;
+    department: string;
+    managerId?: string | null;
+    email?: string;
+    level?: number;
+}
+/**
+ * Structured employee node in org chart
+ */
+interface OrgChartNode {
+    id: string;
+    name: string;
+    title: string;
+    department: string;
+    email?: string;
+    level: number;
+    managerId?: string | null;
+    directReports: OrgChartNode[];
+    reportCount: number;
+}
+/**
+ * Input interface for org chart formatting
+ */
+interface OrgChartFormatInput {
+    employees: EmployeeInput[];
+}
+/**
+ * Org chart output with metadata
+ */
+interface OrgChart {
+    root: OrgChartNode[];
+    totalEmployees: number;
+    departments: string[];
+    maxDepth: number;
+    orphanedEmployees: string[];
+}
+/**
+ * Org Chart Format Tool
+ * Formats organizational hierarchy data into structured org chart representation
+ */
+declare const orgChartFormatTool: ai.Tool<OrgChartFormatInput, OrgChart>;
+
+export { type OrgChart, type OrgChartNode, orgChartFormatTool as default, orgChartFormatTool };

package/dist/index.js

@@ -0,0 +1,134 @@
+import { tool, jsonSchema } from 'ai';
+
+// src/index.ts
+var orgChartFormatTool = tool({
+  description: "Formats organizational hierarchy data into a structured org chart representation. Processes employee data with manager relationships to create a hierarchical tree structure with reporting relationships, departments, and role titles.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      employees: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "Unique employee identifier"
+            },
+            name: {
+              type: "string",
+              description: "Employee full name"
+            },
+            title: {
+              type: "string",
+              description: "Job title"
+            },
+            department: {
+              type: "string",
+              description: "Department name"
+            },
+            managerId: {
+              type: ["string", "null"],
+              description: "Manager employee ID (null for top-level)"
+            },
+            email: {
+              type: "string",
+              description: "Employee email address"
+            },
+            level: {
+              type: "number",
+              description: "Organizational level (optional, will be calculated if not provided)"
+            }
+          },
+          required: ["id", "name", "title", "department"]
+        },
+        minItems: 1,
+        description: "Array of employee objects with manager relationships"
+      }
+    },
+    required: ["employees"],
+    additionalProperties: false
+  }),
+  execute: async ({ employees }) => {
+    if (!Array.isArray(employees) || employees.length === 0) {
+      throw new Error("Employees must be a non-empty array");
+    }
+    for (const emp of employees) {
+      if (!emp.id || typeof emp.id !== "string") {
+        throw new Error("Each employee must have a valid id");
+      }
+      if (!emp.name || typeof emp.name !== "string") {
+        throw new Error(`Employee ${emp.id} must have a valid name`);
+      }
+      if (!emp.title || typeof emp.title !== "string") {
+        throw new Error(`Employee ${emp.id} must have a valid title`);
+      }
+      if (!emp.department || typeof emp.department !== "string") {
+        throw new Error(`Employee ${emp.id} must have a valid department`);
+      }
+    }
+    const ids = /* @__PURE__ */ new Set();
+    for (const emp of employees) {
+      if (ids.has(emp.id)) {
+        throw new Error(`Duplicate employee ID found: ${emp.id}`);
+      }
+      ids.add(emp.id);
+    }
+    try {
+      const employeeMap = /* @__PURE__ */ new Map();
+      for (const emp of employees) {
+        employeeMap.set(emp.id, emp);
+      }
+      const rootEmployees = [];
+      const orphanedEmployees = [];
+      for (const emp of employees) {
+        if (!emp.managerId || emp.managerId === null) {
+          rootEmployees.push(emp);
+        } else if (!employeeMap.has(emp.managerId)) {
+          orphanedEmployees.push(emp.id);
+          rootEmployees.push(emp);
+        }
+      }
+      if (rootEmployees.length === 0) {
+        throw new Error("No root employees found (circular management structure detected)");
+      }
+      const buildNode = (emp, currentLevel) => {
+        const directReportData = employees.filter((e) => e.managerId === emp.id);
+        const directReports = directReportData.map((report) => buildNode(report, currentLevel + 1));
+        const reportCount = directReports.reduce((sum, dr) => sum + 1 + dr.reportCount, 0);
+        return {
+          id: emp.id,
+          name: emp.name,
+          title: emp.title,
+          department: emp.department,
+          email: emp.email,
+          level: emp.level ?? currentLevel,
+          managerId: emp.managerId,
+          directReports,
+          reportCount
+        };
+      };
+      const root = rootEmployees.map((emp) => buildNode(emp, 0));
+      const calculateMaxDepth = (node) => {
+        if (node.directReports.length === 0) return node.level;
+        return Math.max(...node.directReports.map(calculateMaxDepth));
+      };
+      const maxDepth = Math.max(...root.map(calculateMaxDepth));
+      const departments = Array.from(new Set(employees.map((e) => e.department))).sort();
+      return {
+        root,
+        totalEmployees: employees.length,
+        departments,
+        maxDepth,
+        orphanedEmployees
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to format org chart: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+});
+var index_default = orgChartFormatTool;
+
+export { index_default as default, orgChartFormatTool };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@tpmjs/official-org-chart-format",
+  "version": "0.1.0",
+  "description": "Formats organizational hierarchy data into structured org chart representation",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "hr",
+    "org-chart",
+    "hierarchy",
+    "organization"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3",
+    "@tpmjs/tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/tpmjs.git",
+    "directory": "packages/tools/official/org-chart-format"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "hr",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "tools": [
+      {
+        "name": "orgChartFormatTool",
+        "description": "Formats organizational hierarchy data into structured org chart representation",
+        "parameters": [
+          {
+            "name": "employees",
+            "type": "object[]",
+            "description": "Employee data with manager relationships",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "OrgChart",
+          "description": "Structured organizational chart with hierarchy"
+        }
+      }
+    ]
+  },
+  "dependencies": {
+    "ai": "6.0.0-beta.124"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}