@polpo-ai/core 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,377 @@
+/**
+ * Event type definitions for Polpo.
+ * Pure type declarations — no runtime dependencies.
+ *
+ * The TypedEmitter class (which extends Node.js EventEmitter) lives in the
+ * shell layer (src/core/events.ts), not here.
+ */
+import type { Task, TaskStatus, DimensionScore, MissionStatus, MissionReport, ChannelType, PeerIdentity } from "./types.js";
+export interface PolpoEventMap {
+    "task:created": {
+        task: Task;
+    };
+    "task:transition": {
+        taskId: string;
+        from: TaskStatus;
+        to: TaskStatus;
+        task: Task;
+    };
+    "task:updated": {
+        taskId: string;
+        task: Task;
+    };
+    "task:removed": {
+        taskId: string;
+    };
+    "agent:spawned": {
+        taskId: string;
+        agentName: string;
+        taskTitle: string;
+    };
+    "agent:finished": {
+        taskId: string;
+        agentName: string;
+        exitCode: number;
+        duration: number;
+        sessionId?: string;
+    };
+    "agent:activity": {
+        taskId: string;
+        agentName: string;
+        tool?: string;
+        file?: string;
+        summary?: string;
+    };
+    "assessment:started": {
+        taskId: string;
+    };
+    "assessment:progress": {
+        taskId: string;
+        message: string;
+    };
+    "assessment:check:started": {
+        taskId: string;
+        index: number;
+        total: number;
+        type: string;
+        label: string;
+    };
+    "assessment:check:complete": {
+        taskId: string;
+        index: number;
+        total: number;
+        type: string;
+        label: string;
+        passed: boolean;
+        message?: string;
+    };
+    "assessment:complete": {
+        taskId: string;
+        passed: boolean;
+        scores?: DimensionScore[];
+        globalScore?: number;
+        message?: string;
+    };
+    "assessment:corrected": {
+        taskId: string;
+        corrections: number;
+    };
+    "orchestrator:started": {
+        project: string;
+        agents: string[];
+    };
+    "orchestrator:tick": {
+        pending: number;
+        running: number;
+        done: number;
+        failed: number;
+        queued: number;
+    };
+    "orchestrator:deadlock": {
+        taskIds: string[];
+    };
+    "orchestrator:shutdown": Record<string, never>;
+    "task:retry": {
+        taskId: string;
+        attempt: number;
+        maxRetries: number;
+    };
+    "task:retry:blocked": {
+        taskId: string;
+        reason: string;
+    };
+    "task:fix": {
+        taskId: string;
+        attempt: number;
+        maxFix: number;
+    };
+    "task:maxRetries": {
+        taskId: string;
+    };
+    "task:question": {
+        taskId: string;
+        question: string;
+    };
+    "task:answered": {
+        taskId: string;
+        question: string;
+        answer: string;
+    };
+    "deadlock:detected": {
+        taskIds: string[];
+        resolvableCount: number;
+    };
+    "deadlock:resolving": {
+        taskId: string;
+        failedDepId: string;
+    };
+    "deadlock:resolved": {
+        taskId: string;
+        failedDepId: string;
+        action: "absorb" | "retry";
+        reason: string;
+    };
+    "deadlock:unresolvable": {
+        taskId: string;
+        reason: string;
+    };
+    "task:timeout": {
+        taskId: string;
+        elapsed: number;
+        timeout: number;
+    };
+    "agent:stale": {
+        taskId: string;
+        agentName: string;
+        idleMs: number;
+        action: "warning" | "killed";
+    };
+    "task:recovered": {
+        taskId: string;
+        title: string;
+        previousStatus: TaskStatus;
+    };
+    "mission:saved": {
+        missionId: string;
+        name: string;
+        status: MissionStatus;
+    };
+    "mission:executed": {
+        missionId: string;
+        group: string;
+        taskCount: number;
+    };
+    "mission:completed": {
+        missionId: string;
+        group: string;
+        allPassed: boolean;
+        report: MissionReport;
+    };
+    "mission:resumed": {
+        missionId: string;
+        name: string;
+        retried: number;
+        pending: number;
+    };
+    "mission:deleted": {
+        missionId: string;
+        deletedTasks?: number;
+    };
+    "session:created": {
+        sessionId: string;
+        title?: string;
+    };
+    "message:added": {
+        sessionId: string;
+        messageId: string;
+        role: "user" | "assistant";
+    };
+    "approval:requested": {
+        requestId: string;
+        gateId: string;
+        gateName: string;
+        taskId?: string;
+        missionId?: string;
+    };
+    "approval:resolved": {
+        requestId: string;
+        status: "approved" | "rejected";
+        resolvedBy?: string;
+    };
+    "approval:rejected": {
+        requestId: string;
+        taskId?: string;
+        feedback: string;
+        rejectionCount: number;
+        resolvedBy?: string;
+    };
+    "approval:timeout": {
+        requestId: string;
+        action: "approve" | "reject";
+    };
+    "escalation:triggered": {
+        taskId: string;
+        level: number;
+        handler: string;
+        target?: string;
+    };
+    "escalation:resolved": {
+        taskId: string;
+        level: number;
+        action: string;
+    };
+    "escalation:human": {
+        taskId: string;
+        message: string;
+        channels?: string[];
+    };
+    "sla:warning": {
+        entityId: string;
+        entityType: "task" | "mission";
+        deadline: string;
+        elapsed: number;
+        remaining: number;
+        percentUsed: number;
+    };
+    "sla:violated": {
+        entityId: string;
+        entityType: "task" | "mission";
+        deadline: string;
+        overdueMs: number;
+    };
+    "sla:met": {
+        entityId: string;
+        entityType: "task" | "mission";
+        deadline: string;
+        marginMs: number;
+    };
+    "checkpoint:reached": {
+        missionId?: string;
+        group: string;
+        checkpointName: string;
+        message?: string;
+        afterTasks: string[];
+        blocksTasks: string[];
+        reachedAt: string;
+    };
+    "checkpoint:resumed": {
+        missionId?: string;
+        group: string;
+        checkpointName: string;
+    };
+    "delay:started": {
+        missionId?: string;
+        group: string;
+        delayName: string;
+        duration: string;
+        message?: string;
+        afterTasks: string[];
+        blocksTasks: string[];
+        startedAt: string;
+        expiresAt: string;
+    };
+    "delay:expired": {
+        missionId?: string;
+        group: string;
+        delayName: string;
+    };
+    "quality:gate:passed": {
+        missionId: string;
+        gateName: string;
+        avgScore?: number;
+    };
+    "quality:gate:failed": {
+        missionId: string;
+        gateName: string;
+        avgScore?: number;
+        reason: string;
+    };
+    "quality:threshold:failed": {
+        missionId: string;
+        avgScore: number;
+        threshold: number;
+    };
+    "schedule:triggered": {
+        scheduleId: string;
+        missionId: string;
+        expression: string;
+    };
+    "schedule:created": {
+        scheduleId: string;
+        missionId: string;
+        nextRunAt?: string;
+    };
+    "schedule:completed": {
+        scheduleId: string;
+        missionId: string;
+    };
+    "notification:sent": {
+        ruleId: string;
+        channel: string;
+        event: string;
+    };
+    "notification:failed": {
+        ruleId: string;
+        channel: string;
+        error: string;
+    };
+    "config:reloaded": {
+        timestamp: string;
+    };
+    "gateway:started": {
+        channels: ChannelType[];
+    };
+    "gateway:stopped": Record<string, never>;
+    "peer:paired": {
+        peer: PeerIdentity;
+        channel: ChannelType;
+    };
+    "peer:message": {
+        peerId: string;
+        channel: ChannelType;
+        text: string;
+        sessionId: string;
+    };
+    "peer:blocked": {
+        peerId: string;
+        channel: ChannelType;
+        reason: string;
+    };
+    "peer:presence": {
+        peerId: string;
+        channel: ChannelType;
+        status: "online" | "offline";
+    };
+    "watcher:created": {
+        watcherId: string;
+        taskId: string;
+        targetStatus: TaskStatus;
+    };
+    "watcher:fired": {
+        watcherId: string;
+        taskId: string;
+        targetStatus: TaskStatus;
+        actionType: string;
+    };
+    "watcher:removed": {
+        watcherId: string;
+    };
+    "action:triggered": {
+        ruleId: string;
+        actionType: string;
+        result?: string;
+        error?: string;
+    };
+    "file:changed": {
+        path: string;
+        dir: string;
+        action: "created" | "modified" | "deleted" | "renamed";
+        source: "agent" | "server" | "chat";
+    };
+    "log": {
+        level: "info" | "warn" | "error" | "debug";
+        message: string;
+    };
+}
+export type PolpoEvent = keyof PolpoEventMap;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,9 @@
+/**
+ * Event type definitions for Polpo.
+ * Pure type declarations — no runtime dependencies.
+ *
+ * The TypedEmitter class (which extends Node.js EventEmitter) lives in the
+ * shell layer (src/core/events.ts), not here.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,185 @@
+import type { Task, AgentConfig, Mission, MissionReport, TaskResult, AssessmentResult, TaskExpectation, ExpectedOutcome, RetryPolicy, ScopedNotificationRules } from "./types.js";
+export type LifecycleHook = "task:create" | "task:spawn" | "task:transition" | "task:complete" | "task:fail" | "task:retry" | "mission:execute" | "mission:complete" | "assessment:run" | "assessment:complete" | "quality:gate" | "quality:sla" | "schedule:trigger" | "orchestrator:tick" | "orchestrator:shutdown";
+export interface HookPayloads {
+    "task:create": {
+        title: string;
+        description: string;
+        assignTo: string;
+        expectations?: TaskExpectation[];
+        expectedOutcomes?: ExpectedOutcome[];
+        dependsOn?: string[];
+        group?: string;
+        missionId?: string;
+        maxDuration?: number;
+        retryPolicy?: RetryPolicy;
+        notifications?: ScopedNotificationRules;
+        sideEffects?: boolean;
+        draft?: boolean;
+    };
+    "task:spawn": {
+        task: Task;
+        agent: AgentConfig;
+    };
+    "task:transition": {
+        taskId: string;
+        from: string;
+        to: string;
+        task: Task;
+    };
+    "task:complete": {
+        taskId: string;
+        task: Task;
+        result?: TaskResult;
+        assessment?: AssessmentResult;
+    };
+    "task:fail": {
+        taskId: string;
+        task: Task;
+        result?: TaskResult;
+        reason?: string;
+    };
+    "task:retry": {
+        taskId: string;
+        task: Task;
+        attempt: number;
+        maxRetries: number;
+    };
+    "mission:execute": {
+        missionId: string;
+        mission: Mission;
+        taskCount: number;
+    };
+    "mission:complete": {
+        missionId: string;
+        mission: Mission;
+        allPassed: boolean;
+        report: MissionReport;
+    };
+    "assessment:run": {
+        taskId: string;
+        task: Task;
+    };
+    "assessment:complete": {
+        taskId: string;
+        task: Task;
+        assessment: AssessmentResult;
+        passed: boolean;
+    };
+    "quality:gate": {
+        missionId: string;
+        gateName: string;
+        avgScore?: number;
+        allPassed: boolean;
+        tasks: Array<{
+            taskId: string;
+            title: string;
+            status: string;
+            score?: number;
+        }>;
+    };
+    "quality:sla": {
+        entityId: string;
+        entityType: "task" | "mission";
+        deadline: string;
+        status: "warning" | "violated";
+        percentUsed: number;
+    };
+    "schedule:trigger": {
+        scheduleId: string;
+        missionId: string;
+        expression: string;
+    };
+    "orchestrator:tick": {
+        pending: number;
+        running: number;
+        done: number;
+        failed: number;
+    };
+    "orchestrator:shutdown": Record<string, never>;
+}
+export type HookPhase = "before" | "after";
+export interface HookContext<T = unknown> {
+    /** Which hook point fired. */
+    readonly hook: LifecycleHook;
+    /** "before" hooks can cancel/modify; "after" hooks are observe-only. */
+    readonly phase: HookPhase;
+    /** The payload — mutable reference for "before" hooks. */
+    data: T;
+    /** Cancel the operation (only available in "before" hooks). */
+    cancel(reason?: string): void;
+    /** Whether any handler has called cancel(). */
+    readonly cancelled: boolean;
+    /** Reason provided to cancel(), if any. */
+    readonly cancelReason?: string;
+    /** ISO timestamp when the hook was triggered. */
+    readonly timestamp: string;
+}
+export type HookHandler<T = unknown> = (ctx: HookContext<T>) => void | Promise<void>;
+export interface HookRegistration<K extends LifecycleHook = LifecycleHook> {
+    /** Which lifecycle hook to listen to. */
+    hook: K;
+    /** "before" runs before the operation (can cancel/modify), "after" runs after. */
+    phase: HookPhase;
+    /** The handler function. */
+    handler: HookHandler<HookPayloads[K]>;
+    /** Lower priority runs first. Default: 100. */
+    priority?: number;
+    /** Optional name for debugging/logging. */
+    name?: string;
+}
+export interface BeforeHookResult<T> {
+    /** True if any handler called cancel(). */
+    cancelled: boolean;
+    /** Reason provided to cancel(), if any. */
+    cancelReason?: string;
+    /** The (possibly modified) payload. */
+    data: T;
+}
+/**
+ * Central registry for lifecycle hooks.
+ *
+ * "before" hooks run before an operation and can cancel or modify the payload.
+ * "after" hooks run after the operation completes (fire-and-forget, observe-only).
+ *
+ * Handlers are sorted by priority (ascending) and run sequentially.
+ * Async handlers are awaited — a slow hook delays the operation.
+ */
+export declare class HookRegistry {
+    private registrations;
+    /**
+     * Register a lifecycle hook handler.
+     * Returns an unsubscribe function.
+     */
+    register<K extends LifecycleHook>(reg: HookRegistration<K>): () => void;
+    /**
+     * Run all "before" hooks for a lifecycle point.
+     * Returns whether the operation was cancelled and the (possibly modified) data.
+     *
+     * Handlers run sequentially in priority order.
+     * If a handler calls `cancel()`, remaining handlers still run but the operation is blocked.
+     */
+    runBefore<K extends LifecycleHook>(hook: K, data: HookPayloads[K]): Promise<BeforeHookResult<HookPayloads[K]>>;
+    /**
+     * Run all "after" hooks for a lifecycle point.
+     * Fire-and-forget: errors are logged but never propagate.
+     * "after" hooks cannot cancel or modify anything.
+     */
+    runAfter<K extends LifecycleHook>(hook: K, data: HookPayloads[K]): Promise<void>;
+    /**
+     * Synchronous variant of runBefore — for hot paths where async is not feasible.
+     * Only runs synchronous handlers; async handlers are skipped with a warning.
+     */
+    runBeforeSync<K extends LifecycleHook>(hook: K, data: HookPayloads[K]): BeforeHookResult<HookPayloads[K]>;
+    /** Get the count of registered handlers (for diagnostics). */
+    get size(): number;
+    /** List all registered hooks (for diagnostics). */
+    list(): Array<{
+        hook: LifecycleHook;
+        phase: HookPhase;
+        priority: number;
+        name?: string;
+    }>;
+    /** Remove all registered hooks. */
+    clear(): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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