@useorgx/openclaw-plugin 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * OrgX Clawdbot Plugin — Shared Types
+ *
+ * Types for the plugin's API client and tool interfaces.
+ * Mirrors the server-side types in orgx/lib/client-integration/types.ts
+ */
+export interface OrgXConfig {
+    /** OrgX API key */
+    apiKey: string;
+    /** OrgX user ID for X-Orgx-User-Id header */
+    userId: string;
+    /** OrgX API base URL */
+    baseUrl: string;
+    /** Background sync interval in ms */
+    syncIntervalMs: number;
+    /** Plugin enabled */
+    enabled: boolean;
+}
+export interface OrgSnapshot {
+    /** Active initiatives */
+    initiatives: Initiative[];
+    /** Agent states */
+    agents: AgentState[];
+    /** Active tasks across workstreams */
+    activeTasks: TaskSummary[];
+    /** Pending decisions needing attention */
+    pendingDecisions: Decision[];
+    /** Last sync timestamp */
+    syncedAt: string;
+}
+export interface Initiative {
+    id: string;
+    title: string;
+    status: string;
+    progress?: number;
+    workstreams?: string[];
+}
+export interface AgentState {
+    id: string;
+    name: string;
+    domain: string;
+    status: "active" | "idle" | "throttled";
+    currentTask?: string;
+    lastActive?: string;
+}
+export interface TaskSummary {
+    id: string;
+    title: string;
+    status: string;
+    domain?: string;
+    modelTier?: ModelTier;
+    assignee?: string;
+}
+export interface Decision {
+    id: string;
+    title: string;
+    urgency: "low" | "medium" | "high";
+    context?: string;
+}
+export interface SyncPayload {
+    /** Client-side memory snapshot */
+    memory?: string;
+    /** Today's session log */
+    dailyLog?: string;
+    /** Decisions made this session */
+    decisions?: Array<{
+        id: string;
+        action: "approved" | "rejected";
+        note?: string;
+    }>;
+}
+export interface SyncResponse {
+    /** Active initiatives summary */
+    initiatives: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    /** In-progress tasks */
+    activeTasks: Array<{
+        id: string;
+        title: string;
+        status: string;
+        domain?: string;
+        modelTier: ModelTier;
+    }>;
+    /** Pending decisions needing attention */
+    pendingDecisions: Array<{
+        id: string;
+        title: string;
+        urgency: "low" | "medium" | "high";
+    }>;
+    /** Quality stats per domain */
+    qualityStats: QualityStats[];
+    /** Model routing policy */
+    modelPolicy: ModelRoutingPolicy;
+    /** Server timestamp */
+    syncedAt: string;
+}
+export type ModelTier = "opus" | "sonnet" | "local";
+export type TaskComplexity = "planning" | "execution" | "routine";
+export interface ModelRouting {
+    tier: ModelTier;
+    reason: string;
+    complexity: TaskComplexity;
+    estimatedTokens: number;
+}
+export interface ModelRoutingPolicy {
+    planningPatterns: string[];
+    executionPatterns: string[];
+    routinePatterns: string[];
+    domainOverrides: Record<string, ModelTier>;
+    budget: {
+        dailyUsd: number;
+        opusMaxPercentage: number;
+        localMinPercentage: number;
+    };
+}
+export interface QualityScore {
+    taskId: string;
+    domain: string;
+    score: number;
+    notes?: string;
+    scoredBy?: "human" | "auto" | "peer";
+}
+export interface QualityStats {
+    domain: string;
+    totalTasks: number;
+    avgScore: number;
+    recentTrend: "improving" | "stable" | "declining";
+    isThrottled: boolean;
+    throttleReason?: string;
+}
+export interface SpawnGuardResult {
+    allowed: boolean;
+    modelTier: ModelTier;
+    checks: {
+        rateLimit: {
+            passed: boolean;
+            current: number;
+            max: number;
+        };
+        qualityGate: {
+            passed: boolean;
+            score: number;
+            threshold: number;
+        };
+        taskAssigned: {
+            passed: boolean;
+            taskId?: string;
+            status?: string;
+        };
+    };
+    blockedReason?: string;
+}
+export interface Entity {
+    id: string;
+    type: string;
+    title: string;
+    summary?: string;
+    status?: string;
+    parentId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+export interface EntityCreatePayload {
+    title: string;
+    summary?: string;
+    status?: string;
+    parentId?: string;
+    [key: string]: unknown;
+}
+export interface EntityUpdatePayload {
+    [key: string]: unknown;
+}
+export interface EntityListFilters {
+    status?: string;
+    limit?: number;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * OrgX Clawdbot Plugin — Shared Types
+ *
+ * Types for the plugin's API client and tool interfaces.
+ * Mirrors the server-side types in orgx/lib/client-integration/types.ts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,73 @@
+{
+  "id": "orgx",
+  "name": "OrgX Integration",
+  "version": "1.0.0",
+  "description": "Connects Clawdbot to OrgX for agent orchestration, quality gates, and model routing",
+  "entry": "./dist/index.js",
+  "author": "OrgX Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orgx/orgx"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "capabilities": {
+    "tools": true,
+    "services": true,
+    "cli": true,
+    "http": true
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "OrgX API key for authentication"
+      },
+      "baseUrl": {
+        "type": "string",
+        "default": "https://www.useorgx.com",
+        "description": "OrgX API base URL"
+      },
+      "syncIntervalMs": {
+        "type": "number",
+        "default": 300000,
+        "description": "Background sync interval in milliseconds (default: 5 minutes)"
+      },
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable or disable the OrgX plugin"
+      },
+      "dashboardEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable the OrgX live dashboard at /orgx/live"
+      }
+    },
+    "required": []
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "OrgX API Key",
+      "sensitive": true,
+      "placeholder": "orgx_..."
+    },
+    "baseUrl": {
+      "label": "OrgX API Base URL",
+      "placeholder": "https://www.useorgx.com"
+    },
+    "syncIntervalMs": {
+      "label": "Sync Interval (ms)",
+      "placeholder": "300000"
+    },
+    "enabled": {
+      "label": "Enable Plugin"
+    },
+    "dashboardEnabled": {
+      "label": "Enable Live Dashboard"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@useorgx/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "OrgX plugin for OpenClaw — agent orchestration, quality gates, model routing, and live dashboard",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    }
+  },
+  "openclaw": {
+    "plugin": true,
+    "entry": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "dashboard/dist/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "orgx",
+    "agent-orchestration",
+    "mcp",
+    "ai-agents",
+    "quality-gates",
+    "model-routing"
+  ],
+  "author": "OrgX Team <team@useorgx.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/useorgx/openclaw-plugin.git"
+  },
+  "homepage": "https://useorgx.com",
+  "bugs": {
+    "url": "https://github.com/useorgx/openclaw-plugin/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.30",
+    "typescript": "^5.9.3"
+  }
+}