@useorgx/openclaw-plugin 0.3.0 → 0.3.1

package/dist/outbox.d.ts

@@ -12,9 +12,16 @@ export interface OutboxEvent {
     /** Converted to a LiveActivityItem for dashboard display. */
     activityItem: LiveActivityItem;
 }
+export interface OutboxSummary {
+    pendingTotal: number;
+    pendingByQueue: Record<string, number>;
+    oldestEventAt: string | null;
+    newestEventAt: string | null;
+}
 export declare function readOutbox(sessionId: string): Promise<OutboxEvent[]>;
 export declare function appendToOutbox(sessionId: string, event: OutboxEvent): Promise<void>;
 export declare function replaceOutbox(sessionId: string, events: OutboxEvent[]): Promise<void>;
 export declare function readAllOutboxItems(): Promise<LiveActivityItem[]>;
+export declare function readOutboxSummary(): Promise<OutboxSummary>;
 export declare function clearOutbox(sessionId: string): Promise<void>;
 //# sourceMappingURL=outbox.d.ts.map

package/dist/outbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../src/outbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAcD,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAO1E;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwBtE;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlE"}
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../src/outbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA8BnD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAeD,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAO1E;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwBtE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAgDhE;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlE"}

package/dist/outbox.js

@@ -5,18 +5,45 @@
  */
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { readFile, writeFile, mkdir, chmod } from "node:fs/promises";
 const OUTBOX_DIR = join(homedir(), ".openclaw", "orgx-outbox");
+function isSafeOutboxSessionId(value) {
+    const normalized = value.trim();
+    if (!normalized || normalized === "." || normalized === "..")
+        return false;
+    if (normalized.includes("/") || normalized.includes("\\") || normalized.includes("\0")) {
+        return false;
+    }
+    if (normalized.includes(".."))
+        return false;
+    return true;
+}
+function normalizeSessionId(sessionId) {
+    const normalized = sessionId.trim();
+    if (!isSafeOutboxSessionId(normalized)) {
+        throw new Error("Invalid outbox session identifier");
+    }
+    return normalized;
+}
+async function hardenPath(path, mode) {
+    try {
+        await chmod(path, mode);
+    }
+    catch {
+        // best effort
+    }
+}
 async function ensureDir() {
     try {
-        await mkdir(OUTBOX_DIR, { recursive: true });
+        await mkdir(OUTBOX_DIR, { recursive: true, mode: 0o700 });
+        await hardenPath(OUTBOX_DIR, 0o700);
     }
     catch {
         // Directory may already exist
     }
 }
 function outboxPath(sessionId) {
-    return join(OUTBOX_DIR, `${sessionId}.json`);
+    return join(OUTBOX_DIR, `${normalizeSessionId(sessionId)}.json`);
 }
 export async function readOutbox(sessionId) {
     try {
@@ -29,16 +56,22 @@ export async function readOutbox(sessionId) {
 }
 export async function appendToOutbox(sessionId, event) {
     await ensureDir();
+    const targetPath = outboxPath(sessionId);
     const existing = await readOutbox(sessionId);
     existing.push(event);
-    await writeFile(outboxPath(sessionId), JSON.stringify(existing, null, 2), "utf8");
+    await writeFile(targetPath, JSON.stringify(existing, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    await hardenPath(targetPath, 0o600);
 }
 export async function replaceOutbox(sessionId, events) {
     await ensureDir();
+    const targetPath = outboxPath(sessionId);
     if (events.length === 0) {
         try {
             const { unlink } = await import("node:fs/promises");
-            await unlink(outboxPath(sessionId));
+            await unlink(targetPath);
             return;
         }
         catch {
@@ -46,7 +79,11 @@ export async function replaceOutbox(sessionId, events) {
             return;
         }
     }
-    await writeFile(outboxPath(sessionId), JSON.stringify(events, null, 2), "utf8");
+    await writeFile(targetPath, JSON.stringify(events, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    await hardenPath(targetPath, 0o600);
 }
 export async function readAllOutboxItems() {
     try {
@@ -74,6 +111,57 @@ export async function readAllOutboxItems() {
         return [];
     }
 }
+export async function readOutboxSummary() {
+    try {
+        await ensureDir();
+        const { readdir } = await import("node:fs/promises");
+        const files = await readdir(OUTBOX_DIR);
+        const pendingByQueue = {};
+        let pendingTotal = 0;
+        let oldestEpoch = Number.POSITIVE_INFINITY;
+        let newestEpoch = Number.NEGATIVE_INFINITY;
+        for (const file of files) {
+            if (!file.endsWith(".json"))
+                continue;
+            const queueId = file.slice(0, -5);
+            try {
+                const raw = await readFile(join(OUTBOX_DIR, file), "utf8");
+                const events = JSON.parse(raw);
+                const count = Array.isArray(events) ? events.length : 0;
+                pendingByQueue[queueId] = count;
+                pendingTotal += count;
+                for (const event of events) {
+                    const epoch = Date.parse(event.timestamp);
+                    if (!Number.isFinite(epoch))
+                        continue;
+                    oldestEpoch = Math.min(oldestEpoch, epoch);
+                    newestEpoch = Math.max(newestEpoch, epoch);
+                }
+            }
+            catch {
+                pendingByQueue[queueId] = pendingByQueue[queueId] ?? 0;
+            }
+        }
+        return {
+            pendingTotal,
+            pendingByQueue,
+            oldestEventAt: Number.isFinite(oldestEpoch)
+                ? new Date(oldestEpoch).toISOString()
+                : null,
+            newestEventAt: Number.isFinite(newestEpoch)
+                ? new Date(newestEpoch).toISOString()
+                : null,
+        };
+    }
+    catch {
+        return {
+            pendingTotal: 0,
+            pendingByQueue: {},
+            oldestEventAt: null,
+            newestEventAt: null,
+        };
+    }
+}
 export async function clearOutbox(sessionId) {
     try {
         const { unlink } = await import("node:fs/promises");

package/dist/outbox.js.map

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

package/dist/snapshot-store.d.ts

@@ -0,0 +1,10 @@
+import type { OrgSnapshot } from './types.js';
+interface PersistedSnapshot {
+    snapshot: OrgSnapshot;
+    updatedAt: string;
+}
+export declare function readPersistedSnapshot(): PersistedSnapshot | null;
+export declare function writePersistedSnapshot(snapshot: OrgSnapshot): PersistedSnapshot;
+export declare function clearPersistedSnapshot(): void;
+export {};
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../src/snapshot-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,UAAU,iBAAiB;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,IAAI,CAUhE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,iBAAiB,CAkB/E;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C"}

package/dist/snapshot-store.js

@@ -0,0 +1,64 @@
+import { mkdirSync, readFileSync, writeFileSync, chmodSync, existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const SNAPSHOT_DIR = join(homedir(), '.config', 'useorgx', 'openclaw-plugin');
+const SNAPSHOT_FILE = join(SNAPSHOT_DIR, 'snapshot.json');
+function ensureSnapshotDir() {
+    mkdirSync(SNAPSHOT_DIR, { recursive: true, mode: 0o700 });
+    try {
+        chmodSync(SNAPSHOT_DIR, 0o700);
+    }
+    catch {
+        // best effort
+    }
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+export function readPersistedSnapshot() {
+    try {
+        if (!existsSync(SNAPSHOT_FILE))
+            return null;
+        const parsed = parseJson(readFileSync(SNAPSHOT_FILE, 'utf8'));
+        if (!parsed || typeof parsed.updatedAt !== 'string')
+            return null;
+        if (!parsed.snapshot || typeof parsed.snapshot !== 'object')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function writePersistedSnapshot(snapshot) {
+    ensureSnapshotDir();
+    const record = {
+        snapshot,
+        updatedAt: new Date().toISOString(),
+    };
+    writeFileSync(SNAPSHOT_FILE, JSON.stringify(record, null, 2), {
+        mode: 0o600,
+        encoding: 'utf8',
+    });
+    try {
+        chmodSync(SNAPSHOT_FILE, 0o600);
+    }
+    catch {
+        // best effort
+    }
+    return record;
+}
+export function clearPersistedSnapshot() {
+    try {
+        rmSync(SNAPSHOT_FILE, { force: true });
+    }
+    catch {
+        // best effort
+    }
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../src/snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAO1D,SAAS,iBAAiB;IACxB,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAI,KAAa;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,SAAS,CAAoB,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAqB;IAC1D,iBAAiB,EAAE,CAAC;IACpB,MAAM,MAAM,GAAsB;QAChC,QAAQ;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC5D,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,IAAI,CAAC;QACH,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC;QACH,MAAM,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -1,414 +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 type OnboardingStatus = 'idle' | 'starting' | 'awaiting_browser_auth' | 'pairing' | 'connected' | 'error' | 'manual_key';
-export type OnboardingNextAction = 'connect' | 'wait_for_browser' | 'open_dashboard' | 'enter_manual_key' | 'retry' | 'reconnect';
-export interface OnboardingState {
-    status: OnboardingStatus;
-    hasApiKey: boolean;
-    connectionVerified: boolean;
-    workspaceName: string | null;
-    lastError: string | null;
-    nextAction: OnboardingNextAction;
-    docsUrl: string;
-    keySource: 'config' | 'environment' | 'persisted' | 'openclaw-config-file' | 'legacy-dev' | 'none';
-    installationId: string | null;
-    connectUrl: string | null;
-    pairingId: string | null;
-    expiresAt: string | null;
-    pollIntervalMs: number | null;
-}
-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 ReportingSourceClient = 'openclaw' | 'codex' | 'claude-code' | 'api';
-export type ReportingPhase = 'intent' | 'execution' | 'blocked' | 'review' | 'handoff' | 'completed';
-export type ReportingLevel = 'info' | 'warn' | 'error';
-export type TaskStatus = 'todo' | 'in_progress' | 'done' | 'blocked';
-export type MilestoneStatus = 'planned' | 'in_progress' | 'completed' | 'at_risk' | 'cancelled';
-export type DecisionUrgency = 'low' | 'medium' | 'high' | 'urgent';
-export interface EmitActivityRequest {
-    initiative_id: string;
-    message: string;
-    run_id?: string;
-    correlation_id?: string;
-    source_client?: ReportingSourceClient;
-    phase?: ReportingPhase;
-    progress_pct?: number;
-    level?: ReportingLevel;
-    next_step?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface EmitActivityResponse {
-    ok: true;
-    run_id: string;
-    event_id: string | null;
-    reused_run: boolean;
-    auth_mode?: 'service' | 'api_key';
-}
-export type ChangesetOperation = {
-    op: 'task.create';
-    title: string;
-    milestone_id?: string;
-    workstream_id?: string;
-    description?: string;
-    priority?: 'low' | 'medium' | 'high';
-    due_date?: string;
-} | {
-    op: 'task.update';
-    task_id: string;
-    status?: TaskStatus;
-    title?: string;
-    description?: string;
-    priority?: 'low' | 'medium' | 'high';
-    due_date?: string;
-} | {
-    op: 'milestone.update';
-    milestone_id: string;
-    status?: MilestoneStatus;
-    due_date?: string;
-    description?: string;
-} | {
-    op: 'decision.create';
-    title: string;
-    summary?: string;
-    urgency?: DecisionUrgency;
-    options?: string[];
-    blocking?: boolean;
-};
-export interface ApplyChangesetRequest {
-    initiative_id: string;
-    idempotency_key: string;
-    operations: ChangesetOperation[];
-    run_id?: string;
-    correlation_id?: string;
-    source_client?: ReportingSourceClient;
-}
-export interface ApplyChangesetResponse {
-    ok: boolean;
-    changeset_id: string;
-    replayed: boolean;
-    run_id: string;
-    applied_count: number;
-    results: Record<string, unknown>[];
-    event_id: string | null;
-    auth_mode?: 'service' | 'api_key';
-}
-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