@useorgx/openclaw-plugin 0.2.1 → 0.3.1

package/dist/types.d.ts

@@ -1,324 +1,9 @@
 /**
- * OrgX Clawdbot Plugin — Shared Types
+ * Public types entrypoint.
  *
- * Types for the plugin's API client and tool interfaces.
- * Mirrors the server-side types in orgx/lib/client-integration/types.ts
+ * Kept stable because consumers import `@useorgx/openclaw-plugin/types`.
+ * The actual definitions live under `src/contracts/types.ts` so we can
+ * share contracts across codebases without tangling with runtime modules.
  */
-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;
-    /** Workspace state for local↔cloud handoff continuity */
-    workspaceState?: HandoffWorkspaceState;
-    /** Decisions made this session */
-    decisions?: Array<{
-        id: string;
-        action: "approved" | "rejected";
-        note?: string;
-    }>;
-    /** Optional sync cursor from client */
-    memoryCursor?: {
-        lastSyncEventId?: string;
-        lastAppliedHandoffId?: 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;
-    /** Workspace state echo and server-side handoff status */
-    workspaceState: HandoffWorkspaceState;
-    /** Sync cursor for incremental sync */
-    memoryCursor: {
-        lastSyncEventId: string | null;
-        lastAppliedHandoffId: string | null;
-    };
-    /** Server timestamp */
-    syncedAt: string;
-}
-export type RunPhase = 'intent' | 'execution' | 'blocked' | 'review' | 'handoff' | 'completed';
-export interface HandoffWorkspaceState {
-    git?: {
-        branch?: string | null;
-        headSha?: string | null;
-        dirtyFiles?: string[];
-        untrackedFilesCount?: number;
-    };
-    handoff?: {
-        pendingHandoffIds?: string[];
-        lastAppliedHandoffId?: string | null;
-    };
-    memoryCursor?: {
-        lastSyncEventId?: string | null;
-    };
-}
-export interface CheckpointSummary {
-    id: string;
-    runId: string;
-    createdAt: string;
-    tokenCount: number;
-    stepId?: string | null;
-    summary?: string | null;
-    payload: Record<string, unknown>;
-}
-export interface RestoreRequest {
-    checkpointId: string;
-    reason?: string;
-}
-export interface DelegationPreflightResult {
-    scope_quality: 'strong' | 'workable' | 'ambiguous';
-    ambiguities: string[];
-    eta_range: {
-        min_minutes: number;
-        max_minutes: number;
-        confidence: number;
-    };
-    cost_estimate: {
-        min_usd: number;
-        max_usd: number;
-        basis: 'heuristic';
-    };
-    recommended_split: Array<{
-        id: string;
-        title: string;
-        owner_domain: string;
-        acceptance_criteria: 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;
-}
-export type LiveActivityType = 'run_started' | 'run_completed' | 'run_failed' | 'artifact_created' | 'decision_requested' | 'decision_resolved' | 'handoff_requested' | 'handoff_claimed' | 'handoff_fulfilled' | 'blocker_created' | 'milestone_completed' | 'delegation';
-export interface LiveActivityItem {
-    id: string;
-    type: LiveActivityType;
-    title: string;
-    description: string | null;
-    agentId: string | null;
-    agentName: string | null;
-    runId: string | null;
-    initiativeId: string | null;
-    timestamp: string;
-    phase?: RunPhase | null;
-    state?: string | null;
-    kind?: string | null;
-    summary?: string | null;
-    decisionRequired?: boolean;
-    costDelta?: number | null;
-    metadata?: Record<string, unknown>;
-}
-export interface SessionTreeNode {
-    id: string;
-    parentId: string | null;
-    runId: string;
-    title: string;
-    agentId: string | null;
-    agentName: string | null;
-    status: string;
-    progress: number | null;
-    initiativeId: string | null;
-    workstreamId: string | null;
-    groupId: string;
-    groupLabel: string;
-    startedAt: string | null;
-    updatedAt: string | null;
-    lastEventAt: string | null;
-    lastEventSummary: string | null;
-    blockers: string[];
-    phase?: RunPhase | null;
-    state?: string | null;
-    eta?: string | null;
-    cost?: number | null;
-    checkpointCount?: number | null;
-    blockerReason?: string | null;
-}
-export interface SessionTreeEdge {
-    parentId: string;
-    childId: string;
-}
-export interface SessionTreeGroup {
-    id: string;
-    label: string;
-    status: string | null;
-}
-export interface SessionTreeResponse {
-    nodes: SessionTreeNode[];
-    edges: SessionTreeEdge[];
-    groups: SessionTreeGroup[];
-}
-export interface HandoffEvent {
-    id: string;
-    handoffId: string;
-    eventType: string;
-    actorType: string | null;
-    actorId: string | null;
-    payload: Record<string, unknown> | null;
-    createdAt: string;
-}
-export interface HandoffSummary {
-    id: string;
-    title: string;
-    status: string;
-    priority: string | null;
-    summary: string | null;
-    currentActorType: string | null;
-    currentActorId: string | null;
-    createdAt: string;
-    updatedAt: string;
-    events: HandoffEvent[];
-}
+export * from "./contracts/types.js";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC"}

package/dist/types.js

@@ -1,8 +1,9 @@
 /**
- * OrgX Clawdbot Plugin — Shared Types
+ * Public types entrypoint.
  *
- * Types for the plugin's API client and tool interfaces.
- * Mirrors the server-side types in orgx/lib/client-integration/types.ts
+ * Kept stable because consumers import `@useorgx/openclaw-plugin/types`.
+ * The actual definitions live under `src/contracts/types.ts` so we can
+ * share contracts across codebases without tangling with runtime modules.
  */
-export {};
+export * from "./contracts/types.js";
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/openclaw.plugin.json

@@ -1,18 +1,19 @@
 {
   "id": "orgx",
   "name": "OrgX Integration",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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"
+    "url": "https://github.com/useorgx/openclaw-plugin.git"
   },
   "engines": {
     "node": ">=18.0.0"
   },
+  "skills": ["skills"],
   "capabilities": {
     "tools": true,
     "services": true,
@@ -53,7 +54,7 @@
     "apiKey": {
       "label": "OrgX API Key",
       "sensitive": true,
-      "placeholder": "orgx_..."
+      "placeholder": "oxk_..."
     },
     "baseUrl": {
       "label": "OrgX API Base URL",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useorgx/openclaw-plugin",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "OrgX plugin for OpenClaw — agent orchestration, quality gates, model routing, and live dashboard",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,13 +27,24 @@
   "files": [
     "dist/",
     "dashboard/dist/",
+    "skills/",
     "openclaw.plugin.json",
     "README.md"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "build": "tsc",
+    "test:hooks": "npm run build:core && node --test tests/**/*.test.mjs",
+    "job:dispatch": "npm run build:core && node ./scripts/run-codex-dispatch-job.mjs",
+    "verify:clean-install": "node ./scripts/verify-clean-install.mjs",
+    "verify:billing": "npm run build:core && node ./scripts/verify-billing-scenarios.mjs",
+    "qa:capture": "node ./scripts/capture-qa-evidence.mjs",
+    "ops:launch-checklist": "node ./scripts/run-launch-checklist.mjs",
+    "install:dashboard": "npm --prefix dashboard ci",
+    "build:dashboard": "npm run install:dashboard && npm --prefix dashboard run build",
+    "build:core": "tsc && node ./scripts/copy-manifest.mjs",
+    "build": "npm run build:dashboard && npm run build:core",
     "clean": "rm -rf dist",
+    "pack": "npm run build && mkdir -p artifacts && npm pack --pack-destination artifacts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -69,6 +80,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.30",
+    "playwright-core": "^1.58.2",
     "typescript": "^5.9.3"
   }
 }

package/skills/orgx/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: orgx
+description: Use when managing work with OrgX — reporting progress, requesting decisions, registering artifacts, syncing memory, checking quality gates, or viewing org status. Activates for phrases like "report progress", "request approval", "create initiative", "check orgx", "sync with orgx", "register artifact".
+version: 3.0.0
+user-invocable: true
+tags:
+  - orchestration
+  - multi-agent
+  - productivity
+  - reporting
+---
+
+# OrgX Integration
+
+Connect to OrgX for multi-agent orchestration, decision workflows, initiative tracking, model routing, quality gates, and structured work reporting.
+
+## Quick Start
+
+```bash
+# Install the plugin
+openclaw plugins install @useorgx/openclaw-plugin
+
+# Or via npx
+npx @useorgx/openclaw-plugin
+```
+
+After installing, pair with OrgX via the live dashboard at `http://127.0.0.1:18789/orgx/live` or set `ORGX_API_KEY` in your environment.
+
+## MCP Tools Reference
+
+### Work Reporting (primary contract)
+
+Use the **two-tool reporting contract** for launch reporting:
+
+**`orgx_emit_activity`** — Append-only telemetry (frequent updates).
+```
+orgx_emit_activity({
+  initiative_id: "aa6d16dc-d450-417f-8a17-fd89bd597195",
+  message: "Implemented auth middleware and validated redirects",
+  phase: "execution",         // intent | execution | blocked | review | handoff | completed
+  progress_pct: 60,           // optional 0-100
+  next_step: "Add integration tests" // optional
+})
+```
+
+**`orgx_apply_changeset`** — Transactional state mutations (batched, idempotent).
+```
+orgx_apply_changeset({
+  initiative_id: "aa6d16dc-d450-417f-8a17-fd89bd597195",
+  idempotency_key: "run_abc_turn_7_commit_1",
+  operations: [
+    { op: "task.update", task_id: "task_uuid", status: "in_progress" },
+    { op: "decision.create", title: "Use SSE for live updates", urgency: "medium" }
+  ]
+})
+```
+
+Backward-compatible aliases:
+- `orgx_report_progress` delegates to `orgx_emit_activity`
+- `orgx_request_decision` delegates to `orgx_apply_changeset` (`decision.create`)
+
+**`orgx_register_artifact`** — Register a deliverable (PR, document, config, etc.).
+```
+orgx_register_artifact({
+  name: "PR #107: Fix Vercel build size",
+  artifact_type: "pr",        // pr | commit | document | config | report | design | other
+  description: "Reduced function size by pruning recursive assets",
+  url: "https://github.com/org/repo/pull/107"  // (optional)
+})
+```
+
+### Org Status & Sync
+
+**`orgx_status`** — View active initiatives, agent states, pending decisions, tasks.
+
+**`orgx_sync`** — Push local memory/daily log to OrgX, receive org context back.
+```
+orgx_sync({
+  memory: "Contents of MEMORY.md",
+  dailyLog: "Today's session summary"
+})
+```
+
+### Quality & Spawning
+
+**`orgx_spawn_check`** — Check quality gate + get model routing before spawning a sub-agent.
+```
+orgx_spawn_check({ domain: "engineering", taskId: "..." })
+// Returns: { allowed: true, modelTier: "sonnet", checks: {...} }
+```
+
+**`orgx_quality_score`** — Record quality score (1-5) for completed work.
+```
+orgx_quality_score({
+  taskId: "...",
+  domain: "engineering",
+  score: 4,
+  notes: "Clean implementation, good test coverage"
+})
+```
+
+### Entity Management
+
+**`orgx_create_entity`** — Create an initiative, workstream, task, decision, milestone, artifact, or blocker.
+
+**`orgx_update_entity`** — Update status/fields on any entity.
+
+**`orgx_list_entities`** — Query entities by type and status.
+
+### Run Control
+
+**`orgx_delegation_preflight`** — Score scope quality and estimate ETA/cost before execution.
+
+**`orgx_run_action`** — Pause, resume, cancel, or rollback a run.
+
+**`orgx_checkpoints_list`** / **`orgx_checkpoint_restore`** — List and restore run checkpoints.
+
+## Reporting Protocol
+
+When working on a task or initiative, follow the two-tool reporting contract. This keeps state deterministic and idempotent.
+
+### On task start
+Call `orgx_emit_activity` with `phase: "intent"` and a brief summary of what you're about to do.
+
+### At meaningful progress points
+Call `orgx_emit_activity` at natural checkpoints: after finishing research, after implementation passes, after tests pass, etc. Include `progress_pct` when possible.
+
+### When you need a human decision
+Call `orgx_apply_changeset` with a `decision.create` operation including clear context/options. Set `blocking: true` when work must pause. Set urgency appropriately:
+- **low** — Can wait hours/days
+- **medium** — Should be decided today
+- **high** — Blocking progress, needs attention soon
+- **urgent** — Critical path, needs immediate attention
+
+### When you produce a deliverable
+Call `orgx_register_artifact` for anything the team should see: PRs, documents, config changes, reports, design files. Include a URL when available.
+
+### On task completion
+1. Call `orgx_emit_activity` with `phase: "completed"` and `progress_pct: 100`
+2. Call `orgx_apply_changeset` to mark task/milestone completion or record final decisions
+3. Call `orgx_quality_score` to self-assess your work (1-5 scale)
+
+### On blockers
+Call `orgx_emit_activity` with `phase: "blocked"` and describe the blocker. If human intervention is needed, use `orgx_apply_changeset` with a `decision.create` op.
+
+## Model Routing
+
+OrgX classifies tasks for model selection:
+
+| Task Type | Tier | Model |
+|---|---|---|
+| Architecture, strategy, decisions, RFCs | **opus** | `anthropic/claude-opus-4-6` |
+| Implementation, code, features, docs | **sonnet** | `anthropic/claude-sonnet-4` |
+| Status checks, formatting, templates | **local** | `ollama/qwen2.5-coder:32b` |
+
+Always call `orgx_spawn_check` before spawning sub-agents to get the right model tier.
+
+## Live Dashboard
+
+The plugin serves a live dashboard at `http://127.0.0.1:18789/orgx/live` showing:
+- **Activity Timeline** — Real-time feed of agent work with threaded session views
+- **Agents/Chats** — Active sessions grouped by agent
+- **Decisions** — Pending approvals with inline approve/reject
+- **Initiatives** — Active workstreams and progress
+
+## Entity API
+
+For direct API access:
+```
+GET  /api/entities?type={type}&status={status}&limit={n}
+POST /api/entities
+PATCH /api/entities
+POST /api/entities/{type}/{id}/{action}
+```
+
+Entity types: `initiative`, `workstream`, `task`, `decision`, `milestone`, `artifact`, `agent`, `blocker`
+
+## MCP Server (mcp.useorgx.com)
+
+For environments that support MCP servers directly (Claude Desktop, Cursor, etc.), connect to `mcp.useorgx.com` for the full suite of 26+ OrgX tools including initiative management, decision workflows, and agent orchestration.