@useorgx/openclaw-plugin 0.4.9 → 0.7.0

package/dist/contracts/shared-types.d.ts

@@ -42,6 +42,12 @@ export interface RuntimeInstance {
     metadata: Record<string, unknown> | null;
 }
 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';
+/**
+ * Canonical event names set in `metadata.event` on activity items.
+ * Keep in sync with emitters in auto-continue-engine.ts, autopilot-operations.ts,
+ * dispatch-lifecycle.ts, and http/index.ts.
+ */
+export type ActivityEventName = 'autopilot_slice_dispatched' | 'autopilot_slice_started' | 'autopilot_slice_heartbeat' | 'autopilot_slice_finished' | 'autopilot_slice_result' | 'autopilot_slice_handoff' | 'autopilot_slice_mcp_handshake_failed' | 'autopilot_slice_timeout' | 'autopilot_slice_log_stall' | 'autopilot_slice_artifact_buffered' | 'autopilot_slice_status_updates_buffered' | 'auto_continue_started' | 'auto_continue_stopped' | 'auto_continue_spawn_guard_blocked' | 'auto_continue_spawn_guard_rate_limited' | 'auto_continue_spawn_guard_rate_limit_overridden' | 'auto_continue_behavior_config_drift_detected' | 'auto_continue_behavior_config_approval_required' | 'auto_continue_behavior_automation_manual_blocked' | 'auto_continue_behavior_automation_supervised_one_shot' | 'autopilot_autofix_scheduled' | 'autopilot_autofix_executed' | 'autopilot_autofix_skipped' | 'orchestrator_dispatch' | 'autopilot_transition' | 'next_up_manual_dispatch_started' | 'scope_completed' | 'session_start' | 'session_stop' | 'heartbeat' | 'decision_buffered' | 'decision_resolved' | 'spawn_guard_degraded' | 'dashboard_run_mark_completed' | 'proof_gate_warning' | 'artifact_registered';
 export interface LiveActivityItem {
     id: string;
     type: LiveActivityType;
@@ -69,16 +75,94 @@ export interface LiveActivityItem {
     lastHeartbeatAt?: string | null;
     metadata?: Record<string, unknown>;
 }
+export declare const KNOWN_ACTIVITY_ACTION_TYPES: readonly ["orchestrator_dispatch", "dispatch_slice", "spawn_worker", "run_heartbeat", "run_state_transition", "run_started", "run_completed", "run_failed", "slice_handoff", "decision_requested", "decision_resolved", "status_updates_applied", "status_updates_buffered", "artifact_registered", "spawn_guard_blocked", "spawn_guard_rate_limited", "behavior_config_review", "auto_fix", "auto_continue_started", "auto_continue_stopped", "milestone_completed", "workflow_error"];
+export type KnownActivityActionType = (typeof KNOWN_ACTIVITY_ACTION_TYPES)[number];
+export type ActivityActionType = KnownActivityActionType | (string & {});
+export declare const KNOWN_ACTIVITY_ACTION_PHASES: readonly ["intent", "dispatch", "execution", "handoff", "review", "completed", "blocked", "error"];
+export type ActivityActionPhase = (typeof KNOWN_ACTIVITY_ACTION_PHASES)[number];
+export declare function normalizeActivityActionType(value: unknown): ActivityActionType | null;
+export declare function isKnownActivityActionType(value: unknown): value is KnownActivityActionType;
+export declare function normalizeActivityActionPhase(value: unknown): ActivityActionPhase | null;
+export declare const KNOWN_DECISION_ACTION_TYPES: readonly ["approve", "reject", "provide_context", "request_info", "confirm_scope", "retry", "resume", "start", "pause", "defer", "cancel", "queue_top", "queue_bottom", "remove_from_queue", "reassign", "assign", "notify", "escalate", "handoff", "spawn", "execute_task", "review_blocker", "review_decision", "open_artifact", "open_logs", "open_session", "open_run", "open_workstream", "open_task", "open_initiative", "open_pr", "open_diff", "open_branch", "open_deal", "update_deal", "open_settings", "open_workspace", "connect_provider", "refresh_credentials", "auto_fix", "ignore_once"];
+export type KnownDecisionActionType = (typeof KNOWN_DECISION_ACTION_TYPES)[number];
+export type DecisionActionType = KnownDecisionActionType | (string & {});
+export declare function normalizeDecisionActionType(value: unknown): DecisionActionType | null;
+export declare function isKnownDecisionActionType(value: unknown): value is KnownDecisionActionType;
+export type LiveDecisionOptionStatus = 'approved' | 'declined' | 'cancelled';
+export interface LiveDecisionOption {
+    id: string;
+    label: string;
+    description: string | null;
+    impliedStatus: LiveDecisionOptionStatus | null;
+    actionType: DecisionActionType | null;
+    requiresNote: boolean;
+}
+export interface LiveDecisionEvidenceRef {
+    evidenceType: string | null;
+    title: string | null;
+    summary: string | null;
+    sourceUrl: string | null;
+    sourcePointer: string | null;
+    freshness: string | null;
+    confidence: number | null;
+    payload: Record<string, unknown> | null;
+}
 export interface LiveDecision {
     id: string;
     title: string;
     context: string | null;
     status: string;
+    priority?: string | null;
+    decisionType?: string | null;
     agentName: string | null;
+    agentId?: string | null;
+    initiativeId?: string | null;
+    workstreamId?: string | null;
+    dueAt?: string | null;
     requestedAt: string | null;
     updatedAt: string | null;
+    sourceSystem?: string | null;
+    conflictSource?: string | null;
+    dedupeKey?: string | null;
+    recommendedAction?: string | null;
+    occurrenceCount?: number | null;
+    firstSeenAt?: string | null;
+    lastSeenAt?: string | null;
+    sourceRunId?: string | null;
+    sourceSessionId?: string | null;
+    sourceStreamId?: string | null;
+    evidenceRefs?: LiveDecisionEvidenceRef[];
     waitingMinutes: number;
     metadata?: Record<string, unknown>;
+    options?: LiveDecisionOption[];
+    selectedOptionId?: string | null;
+}
+export interface SessionBlockerContext {
+    initiativeId: string | null;
+    initiativeIds?: string[];
+    workstreamId: string | null;
+    workstreamIds?: string[];
+    workstreamTitle: string | null;
+    taskIds: string[];
+    milestoneIds: string[];
+    iwmtId?: string | null;
+    iwmtIds?: string[];
+    sliceRunId: string | null;
+    parallelMode: string | null;
+    logPath: string | null;
+    outputPath: string | null;
+}
+export interface SessionBlockerDiagnostics {
+    reason: string | null;
+    source: string | null;
+    errorCode: string | null;
+    errorCategory: string | null;
+    retryable: boolean | null;
+    suggestedActions: string[];
+    eventId: string | null;
+    eventType: string | null;
+    eventTimestamp: string | null;
+    context: SessionBlockerContext;
 }
 export interface SessionTreeNode {
     id: string;
@@ -109,6 +193,7 @@ export interface SessionTreeNode {
     runtimeProvider?: RuntimeProviderLogo | null;
     instanceId?: string | null;
     lastHeartbeatAt?: string | null;
+    blockerDiagnostics?: SessionBlockerDiagnostics | null;
 }
 export interface SessionTreeEdge {
     parentId: string;
@@ -145,3 +230,77 @@ export interface HandoffSummary {
     updatedAt: string;
     events: HandoffEvent[];
 }
+export type TriageItemKind = 'decision_required' | 'blocked_intervention' | 'review_required' | 'failure_diagnostic';
+export type TriageItemStatus = 'open' | 'snoozed' | 'resolved' | 'dismissed';
+export type TriageSeverity = 'critical' | 'high' | 'medium' | 'low';
+export type TriageActionType = 'approve' | 'reject' | 'retry' | 'autofix' | 'defer' | 'snooze' | 'dismiss';
+export interface TriageAction {
+    action: TriageActionType;
+    label: string;
+    description: string;
+    consequences: string;
+    requiresNote: boolean;
+    available: boolean;
+}
+export interface ProofBundle {
+    artifactRefs: string[];
+    fileChanges: string[];
+    prRefs: string[];
+    logRefs: string[];
+    decisionRefs: string[];
+}
+export interface TriageImpact {
+    initiativeCount: number;
+    workstreamCount: number;
+    downstreamBlockedCount: number;
+}
+export interface LiveTriageItem {
+    id: string;
+    kind: TriageItemKind;
+    status: TriageItemStatus;
+    title: string;
+    summary: string;
+    initiativeId: string | null;
+    initiativeTitle: string | null;
+    workstreamId: string | null;
+    workstreamTitle: string | null;
+    taskId: string | null;
+    taskTitle: string | null;
+    sourceSystem: string | null;
+    conflictSource: string | null;
+    dedupeKey: string | null;
+    occurrenceCount: number;
+    severity: TriageSeverity;
+    blocking: boolean;
+    recommendedAction: string | null;
+    agentId: string | null;
+    impact: TriageImpact;
+    proofBundle: ProofBundle;
+    actionContract: TriageAction[];
+    createdAt: string;
+    updatedAt: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    snoozedUntil: string | null;
+    sourceDecisionId: string | null;
+    sourceActivityId: string | null;
+}
+export interface TriageActionRequest {
+    action: string;
+    note?: string;
+    optionId?: string;
+    snoozeDurationMinutes?: number;
+}
+export interface TriageActionResponse {
+    ok: boolean;
+    itemStatus: TriageItemStatus;
+    continuationPlan: string | null;
+    sideEffects: string[];
+}
+export interface TriageListResponse {
+    ok: boolean;
+    items: LiveTriageItem[];
+    total: number;
+    generatedAt: string;
+    degraded?: string[];
+}

package/dist/contracts/shared-types.js

@@ -1,3 +1,179 @@
 // Canonical shared types consumed by both core plugin code and dashboard code.
 // Keep this file dependency-free so it can be imported across build boundaries.
-export {};
+export const KNOWN_ACTIVITY_ACTION_TYPES = [
+    "orchestrator_dispatch",
+    "dispatch_slice",
+    "spawn_worker",
+    "run_heartbeat",
+    "run_state_transition",
+    "run_started",
+    "run_completed",
+    "run_failed",
+    "slice_handoff",
+    "decision_requested",
+    "decision_resolved",
+    "status_updates_applied",
+    "status_updates_buffered",
+    "artifact_registered",
+    "spawn_guard_blocked",
+    "spawn_guard_rate_limited",
+    "behavior_config_review",
+    "auto_fix",
+    "auto_continue_started",
+    "auto_continue_stopped",
+    "milestone_completed",
+    "workflow_error",
+];
+export const KNOWN_ACTIVITY_ACTION_PHASES = [
+    "intent",
+    "dispatch",
+    "execution",
+    "handoff",
+    "review",
+    "completed",
+    "blocked",
+    "error",
+];
+const ACTIVITY_ACTION_TYPE_ALIASES = {
+    orchestrator: "orchestrator_dispatch",
+    dispatch: "dispatch_slice",
+    dispatched: "dispatch_slice",
+    start: "run_started",
+    started: "run_started",
+    stop: "auto_continue_stopped",
+    stopped: "auto_continue_stopped",
+    complete: "run_completed",
+    completed: "run_completed",
+    fail: "run_failed",
+    failed: "run_failed",
+};
+export function normalizeActivityActionType(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    const alias = ACTIVITY_ACTION_TYPE_ALIASES[normalized];
+    if (alias)
+        return alias;
+    return normalized.replace(/\s+/g, "_");
+}
+export function isKnownActivityActionType(value) {
+    if (typeof value !== "string")
+        return false;
+    return KNOWN_ACTIVITY_ACTION_TYPES.includes(value);
+}
+export function normalizeActivityActionPhase(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    if (KNOWN_ACTIVITY_ACTION_PHASES.includes(normalized)) {
+        return normalized;
+    }
+    return null;
+}
+export const KNOWN_DECISION_ACTION_TYPES = [
+    "approve",
+    "reject",
+    "provide_context",
+    "request_info",
+    "confirm_scope",
+    "retry",
+    "resume",
+    "start",
+    "pause",
+    "defer",
+    "cancel",
+    "queue_top",
+    "queue_bottom",
+    "remove_from_queue",
+    "reassign",
+    "assign",
+    "notify",
+    "escalate",
+    "handoff",
+    "spawn",
+    "execute_task",
+    "review_blocker",
+    "review_decision",
+    "open_artifact",
+    "open_logs",
+    "open_session",
+    "open_run",
+    "open_workstream",
+    "open_task",
+    "open_initiative",
+    "open_pr",
+    "open_diff",
+    "open_branch",
+    "open_deal",
+    "update_deal",
+    "open_settings",
+    "open_workspace",
+    "connect_provider",
+    "refresh_credentials",
+    "auto_fix",
+    "ignore_once",
+];
+const DECISION_ACTION_TYPE_ALIASES = {
+    declined: "reject",
+    decline: "reject",
+    deny: "reject",
+    dismiss: "ignore_once",
+    retry_slice: "retry",
+    continue: "resume",
+    restart: "resume",
+    play: "start",
+    stop: "pause",
+    snooze: "defer",
+    queue: "queue_bottom",
+    add_to_end: "queue_bottom",
+    add_to_queue: "queue_bottom",
+    queue_to_end: "queue_bottom",
+    queue_to_bottom: "queue_bottom",
+    queue_to_top: "queue_top",
+    move_to_top: "queue_top",
+    move_to_bottom: "queue_bottom",
+    remove: "remove_from_queue",
+    remove_queue: "remove_from_queue",
+    unqueue: "remove_from_queue",
+    openartifact: "open_artifact",
+    open_artifacts: "open_artifact",
+    open_pr_diff: "open_diff",
+    open_pull_request: "open_pr",
+    open_work_item: "open_task",
+    providecontext: "provide_context",
+    request_context: "request_info",
+    ask_info: "request_info",
+    ask_question: "request_info",
+    reassign_agent: "reassign",
+    assign_agent: "assign",
+    spawn_agent: "spawn",
+    connect_credentials: "connect_provider",
+    fix_credentials: "refresh_credentials",
+    refresh_credential: "refresh_credentials",
+    autofix: "auto_fix",
+    auto_resolve: "auto_fix",
+};
+const KNOWN_DECISION_ACTION_TYPE_SET = new Set(KNOWN_DECISION_ACTION_TYPES);
+export function normalizeDecisionActionType(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    if (KNOWN_DECISION_ACTION_TYPE_SET.has(normalized)) {
+        return normalized;
+    }
+    if (DECISION_ACTION_TYPE_ALIASES[normalized]) {
+        return DECISION_ACTION_TYPE_ALIASES[normalized];
+    }
+    return normalized;
+}
+export function isKnownDecisionActionType(value) {
+    if (typeof value !== "string")
+        return false;
+    return KNOWN_DECISION_ACTION_TYPE_SET.has(value.trim().toLowerCase());
+}

package/dist/contracts/skill-pack-schema.d.ts

@@ -0,0 +1,192 @@
+export declare const OPENCLAW_SKILL_PACK_SCHEMA_VERSION: "openclaw-skill-pack.v1";
+export declare const ORGX_AGENT_DOMAINS: readonly ["engineering", "product", "design", "marketing", "sales", "operations", "orchestration"];
+export type OrgxAgentDomainName = (typeof ORGX_AGENT_DOMAINS)[number];
+export type ManifestConfigType = "openclaw_skills" | "openclawSkills" | "openclaw.skills" | "none";
+export declare const OPENCLAW_SKILLS_MAP_JSON_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly engineering: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly product: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly design: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly marketing: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly sales: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly operations: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly orchestration: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+    };
+};
+export declare const OPENCLAW_SKILL_PACK_MANIFEST_JSON_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.useorgx.com/openclaw-skill-pack/v1.json";
+    readonly title: "OrgX OpenClaw Skill Pack Manifest";
+    readonly description: "Behavior config manifest for OpenClaw skill overrides by domain.";
+    readonly type: "object";
+    readonly additionalProperties: true;
+    readonly oneOf: readonly [{
+        readonly type: "object";
+        readonly additionalProperties: true;
+        readonly properties: {
+            readonly schema_version: {
+                readonly type: "string";
+                readonly const: "openclaw-skill-pack.v1";
+            };
+            readonly openclaw_skills: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly engineering: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly product: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly design: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly marketing: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly sales: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly operations: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly orchestration: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["openclaw_skills"];
+    }, {
+        readonly type: "object";
+        readonly additionalProperties: true;
+        readonly properties: {
+            readonly schema_version: {
+                readonly type: "string";
+                readonly const: "openclaw-skill-pack.v1";
+            };
+            readonly openclawSkills: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly engineering: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly product: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly design: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly marketing: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly sales: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly operations: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly orchestration: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["openclawSkills"];
+    }, {
+        readonly type: "object";
+        readonly additionalProperties: true;
+        readonly properties: {
+            readonly schema_version: {
+                readonly type: "string";
+                readonly const: "openclaw-skill-pack.v1";
+            };
+            readonly openclaw: {
+                readonly type: "object";
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly skills: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly engineering: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly product: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly design: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly marketing: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly sales: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly operations: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly orchestration: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                };
+                readonly required: readonly ["skills"];
+            };
+        };
+        readonly required: readonly ["openclaw"];
+    }];
+};
+export declare function validateOpenClawSkillPackManifest(manifest: unknown): {
+    ok: boolean;
+    configType: ManifestConfigType;
+    openclaw_skills: Partial<Record<OrgxAgentDomainName, string>>;
+    errors: string[];
+};