crewly 1.12.1 → 1.13.1

package/dist/cli/backend/src/types/orchestrator-state.types.d.ts

@@ -0,0 +1,531 @@
+/**
+ * Orchestrator State Persistence Types
+ *
+ * Types for saving and restoring orchestrator state across
+ * restarts, enabling continuous operation and self-improvement.
+ *
+ * @module types/orchestrator-state
+ */
+/**
+ * State file paths configuration
+ */
+export declare const STATE_PATHS: {
+    readonly STATE_DIR: ".crewly/state";
+    readonly CURRENT_STATE: "orchestrator-state.json";
+    readonly BACKUP_DIR: "backups";
+    readonly SELF_IMPROVEMENT_DIR: "self-improvement";
+};
+/**
+ * State version for migrations
+ */
+export declare const STATE_VERSION = "1.0.0";
+/**
+ * Maximum messages to persist per conversation
+ */
+export declare const MAX_PERSISTED_MESSAGES = 50;
+/**
+ * Checkpoint interval in milliseconds (1 minute)
+ */
+export declare const CHECKPOINT_INTERVAL_MS = 60000;
+/**
+ * Top-level orchestrator runtime mode.
+ *
+ * - `'normal'` — Standard orchestrator behavior; the role prompt at
+ *   `config/roles/orchestrator/prompt.md` is loaded and the full skill set
+ *   is available.
+ * - `'onboarding'` — Cold-start onboarding mode. The `ONBOARDING_MODE_SYSTEM_PROMPT`
+ *   is loaded instead of the normal role prompt, and the skill set is
+ *   filtered to the `ONBOARDING_SKILL_ALLOWLIST` (recall/remember/record-learning
+ *   + 2 onboarding-specific skills). `delegate-task`, `start-agent`, `stop-agent`
+ *   are disabled — orc cannot delegate while onboarding the customer.
+ * - `'onboarding-provisioning'` — Future-reserved (Onboarding v3 W3+, materializer
+ *   2-phase commit). Declared now so persisted states from later milestones
+ *   round-trip cleanly through `state-persistence.service`. Not wired in W1.
+ *
+ * Detection of the cold-start condition lives in `OnboardingBootstrapService`
+ * (B1); the mode is set during orc bootstrap by `crewly-agent-runtime.service`
+ * before the system prompt is composed.
+ */
+export type OrchestratorMode = 'normal' | 'onboarding' | 'onboarding-provisioning';
+/**
+ * Valid orchestrator modes array — single source of truth for runtime
+ * validation and the type guard below.
+ */
+export declare const ORCHESTRATOR_MODES: readonly OrchestratorMode[];
+/**
+ * Default orchestrator mode used when state is freshly initialized or
+ * round-tripped from an older state file that predates the `mode` field.
+ */
+export declare const DEFAULT_ORCHESTRATOR_MODE: OrchestratorMode;
+/**
+ * Reasons for state checkpoint
+ */
+export type CheckpointReason = 'scheduled' | 'before_restart' | 'task_completed' | 'user_request' | 'self_improvement' | 'error_recovery';
+/**
+ * Valid checkpoint reasons array
+ */
+export declare const CHECKPOINT_REASONS: CheckpointReason[];
+/**
+ * Persisted message (minimal for storage)
+ */
+export interface PersistedMessage {
+    /** Role of the message sender */
+    role: 'user' | 'orchestrator' | 'agent';
+    /** Message content */
+    content: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Agent name if from agent */
+    agentName?: string;
+}
+/**
+ * Conversation source types
+ */
+export type ConversationSource = 'chat' | 'slack' | 'api';
+/**
+ * Conversation state for persistence
+ */
+export interface ConversationState {
+    /** Unique conversation ID */
+    id: string;
+    /** Source of the conversation */
+    source: ConversationSource;
+    /** Last N messages for context */
+    recentMessages: PersistedMessage[];
+    /** Summary of older conversation */
+    summary?: string;
+    /** User ID if applicable */
+    userId?: string;
+    /** Channel/thread info for Slack */
+    slackContext?: {
+        channelId: string;
+        threadTs: string;
+    };
+    /** Conversation topic/intent */
+    currentTopic?: string;
+    /** Last activity timestamp */
+    lastActivityAt: string;
+}
+/**
+ * Task status values
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'blocked' | 'paused' | 'completed';
+/**
+ * Task priority levels
+ */
+export type TaskPriority = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Task progress information
+ */
+export interface TaskProgress {
+    /** Percentage complete (0-100) */
+    percentComplete: number;
+    /** Current step description */
+    currentStep?: string;
+    /** Completed steps */
+    completedSteps: string[];
+    /** Remaining steps */
+    remainingSteps?: string[];
+    /** Any blockers */
+    blockers?: string[];
+}
+/**
+ * Task checkpoint for detailed resume
+ */
+export interface TaskCheckpoint {
+    /** Step index when checkpointed */
+    stepIndex: number;
+    /** Partial work data */
+    workData?: Record<string, unknown>;
+    /** Files modified */
+    modifiedFiles?: string[];
+    /** Agent context */
+    agentContext?: string;
+    /** Commands/actions pending */
+    pendingActions?: string[];
+}
+/**
+ * Task state for persistence
+ */
+export interface TaskState {
+    /** Unique task ID */
+    id: string;
+    /** Task title */
+    title: string;
+    /** Task description */
+    description: string;
+    /** Current status */
+    status: TaskStatus;
+    /** Priority level */
+    priority: TaskPriority;
+    /** Assignment info */
+    assignedTo?: string;
+    /** Team ID if assigned to team */
+    teamId?: string;
+    /** Project ID */
+    projectId?: string;
+    /** Progress tracking */
+    progress: TaskProgress;
+    /** Dependencies */
+    blockedBy?: string[];
+    /** Tasks this blocks */
+    blocks?: string[];
+    /** Creation timestamp */
+    createdAt: string;
+    /** Start timestamp */
+    startedAt?: string;
+    /** Last activity timestamp */
+    lastActivityAt?: string;
+    /** Completion timestamp */
+    completedAt?: string;
+    /** Checkpoint for resume */
+    checkpoint?: TaskCheckpoint;
+}
+/**
+ * Agent status values
+ */
+export type AgentStateStatus = 'active' | 'inactive' | 'busy' | 'error';
+/**
+ * Agent last activity info
+ */
+export interface AgentLastActivity {
+    /** Activity type */
+    type: string;
+    /** Activity timestamp */
+    timestamp: string;
+    /** Activity description */
+    description?: string;
+}
+/**
+ * Agent state for persistence
+ */
+export interface AgentState {
+    /** Session name */
+    sessionName: string;
+    /** Agent ID */
+    agentId: string;
+    /** Agent role */
+    role: string;
+    /** Current status */
+    status: AgentStateStatus;
+    /** Current task ID */
+    currentTaskId?: string;
+    /** Current project path */
+    currentProjectPath?: string;
+    /** Context summary for resume */
+    contextSummary?: string;
+    /** Last known activity */
+    lastActivity?: AgentLastActivity;
+}
+/**
+ * Project status values
+ */
+export type ProjectStateStatus = 'active' | 'paused' | 'completed';
+/**
+ * Git state information
+ */
+export interface GitState {
+    /** Current branch */
+    branch: string;
+    /** Last commit hash */
+    lastCommit: string;
+    /** Whether there are uncommitted changes */
+    hasUncommittedChanges: boolean;
+}
+/**
+ * Build state information
+ */
+export interface BuildState {
+    /** Last build status */
+    lastBuildStatus: 'success' | 'failed' | 'unknown';
+    /** Last build timestamp */
+    lastBuildAt?: string;
+    /** Whether tests pass */
+    testsPass: boolean;
+}
+/**
+ * Project state for persistence
+ */
+export interface ProjectState {
+    /** Project ID */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project path */
+    path: string;
+    /** Current status */
+    status: ProjectStateStatus;
+    /** Active task IDs */
+    activeTasks: string[];
+    /** Active agent session names */
+    activeAgents: string[];
+    /** Git state */
+    gitState?: GitState;
+    /** Build/test state */
+    buildState?: BuildState;
+}
+/**
+ * Self-improvement task status
+ */
+export type SelfImprovementStatus = 'planning' | 'implementing' | 'testing' | 'validating' | 'completed' | 'rolled_back';
+/**
+ * Change risk level
+ */
+export type ChangeRisk = 'low' | 'medium' | 'high';
+/**
+ * Planned code change
+ */
+export interface PlannedChange {
+    /** Target file path */
+    file: string;
+    /** Change type */
+    type: 'create' | 'modify' | 'delete';
+    /** Change description */
+    description: string;
+    /** Estimated risk level */
+    risk: ChangeRisk;
+}
+/**
+ * File backup for rollback
+ */
+export interface FileBackup {
+    /** Original file path */
+    path: string;
+    /** Original file content */
+    originalContent: string;
+    /** Backup file path */
+    backupPath: string;
+    /** Content checksum */
+    checksum: string;
+}
+/**
+ * Validation check type
+ */
+export type ValidationCheckType = 'build' | 'test' | 'lint' | 'custom';
+/**
+ * Validation check definition
+ */
+export interface ValidationCheck {
+    /** Check name */
+    name: string;
+    /** Check type */
+    type: ValidationCheckType;
+    /** Command to run */
+    command?: string;
+    /** Whether this check is required */
+    required: boolean;
+    /** Whether the check passed */
+    passed?: boolean;
+    /** Check output */
+    output?: string;
+}
+/**
+ * Self-improvement backup state
+ */
+export interface SelfImprovementBackup {
+    /** Backup ID */
+    id: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Backed up files */
+    files: FileBackup[];
+    /** Git commit before changes */
+    gitCommit?: string;
+}
+/**
+ * Self-improvement current task
+ */
+export interface SelfImprovementTask {
+    /** Task ID */
+    id: string;
+    /** Task description */
+    description: string;
+    /** Target files */
+    targetFiles: string[];
+    /** Planned changes */
+    plannedChanges: PlannedChange[];
+    /** Current status */
+    status: SelfImprovementStatus;
+}
+/**
+ * Rollback plan
+ */
+export interface RollbackPlan {
+    /** Rollback steps */
+    steps: string[];
+    /** Git commit to revert to */
+    gitCommit?: string;
+}
+/**
+ * Self-improvement specific state
+ */
+export interface SelfImprovementState {
+    /** Current improvement task */
+    currentTask?: SelfImprovementTask;
+    /** Backup state before changes */
+    backup?: SelfImprovementBackup;
+    /** Validation requirements */
+    validationChecks: ValidationCheck[];
+    /** Rollback instructions */
+    rollbackPlan?: RollbackPlan;
+}
+/**
+ * Orchestrator metadata
+ */
+export interface OrchestratorMetadata {
+    /** Crewly version */
+    version: string;
+    /** Hostname for identification */
+    hostname: string;
+    /** Process ID */
+    pid: number;
+    /** Start time */
+    startedAt: string;
+    /** Total uptime before checkpoint */
+    uptimeSeconds: number;
+    /** Number of restarts */
+    restartCount: number;
+}
+/**
+ * Overall orchestrator state
+ */
+export interface OrchestratorState {
+    /** Unique state ID */
+    id: string;
+    /** Version for migration compatibility */
+    version: string;
+    /** State checkpoint timestamp */
+    checkpointedAt: string;
+    /** Reason for checkpoint */
+    checkpointReason: CheckpointReason;
+    /**
+     * Top-level orchestrator runtime mode (Onboarding v3 — B2).
+     *
+     * Optional for backwards compatibility: state files written by versions
+     * predating the field load with `mode === undefined`. Loaders should
+     * default to `DEFAULT_ORCHESTRATOR_MODE` when absent.
+     */
+    mode?: OrchestratorMode;
+    /** Active conversation contexts */
+    conversations: ConversationState[];
+    /** Pending/in-progress tasks */
+    tasks: TaskState[];
+    /** Agent assignments and status */
+    agents: AgentState[];
+    /** Project contexts */
+    projects: ProjectState[];
+    /** Self-improvement specific state */
+    selfImprovement?: SelfImprovementState;
+    /** Metadata */
+    metadata: OrchestratorMetadata;
+}
+/**
+ * State change types
+ */
+export type StateChangeType = 'conversation' | 'task' | 'agent' | 'project' | 'self_improvement';
+/**
+ * State change operations
+ */
+export type StateChangeOperation = 'add' | 'update' | 'delete';
+/**
+ * Individual state change
+ */
+export interface StateChange {
+    /** Type of entity changed */
+    type: StateChangeType;
+    /** Operation performed */
+    operation: StateChangeOperation;
+    /** Entity ID */
+    id: string;
+    /** Change data */
+    data?: unknown;
+}
+/**
+ * State diff for incremental updates
+ */
+export interface StateDiff {
+    /** Diff timestamp */
+    timestamp: string;
+    /** Changes in this diff */
+    changes: StateChange[];
+}
+/**
+ * Conversation resume info
+ */
+export interface ConversationResumeInfo {
+    /** Conversation ID */
+    id: string;
+    /** Optional message to send on resume */
+    resumeMessage?: string;
+}
+/**
+ * Task resume info
+ */
+export interface TaskResumeInfo {
+    /** Task ID */
+    id: string;
+    /** Whether to resume from checkpoint */
+    resumeFromCheckpoint: boolean;
+}
+/**
+ * Resume notification
+ */
+export interface ResumeNotification {
+    /** Notification type */
+    type: 'slack' | 'log';
+    /** Notification message */
+    message: string;
+}
+/**
+ * Resume instructions after restart
+ */
+export interface ResumeInstructions {
+    /** Priority order for resumption (entity IDs) */
+    resumeOrder: string[];
+    /** Conversations to re-engage */
+    conversationsToResume: ConversationResumeInfo[];
+    /** Tasks to continue */
+    tasksToResume: TaskResumeInfo[];
+    /** Notifications to send */
+    notifications: ResumeNotification[];
+}
+/**
+ * Check if a value is a valid CheckpointReason
+ *
+ * @param value - Value to check
+ * @returns True if valid CheckpointReason
+ */
+export declare function isValidCheckpointReason(value: string): value is CheckpointReason;
+/**
+ * Check if a value is a valid OrchestratorMode (Onboarding v3 — B2).
+ *
+ * Used by `state-persistence.service` when round-tripping a persisted
+ * state to fall back to `DEFAULT_ORCHESTRATOR_MODE` if the file contains
+ * a corrupted or future-unknown value. Narrows the input to the union.
+ *
+ * @param value - Value to check
+ * @returns True if valid OrchestratorMode
+ */
+export declare function isValidOrchestratorMode(value: unknown): value is OrchestratorMode;
+/**
+ * Check if a value is a valid TaskStatus
+ *
+ * @param value - Value to check
+ * @returns True if valid TaskStatus
+ */
+export declare function isValidTaskStatus(value: string): value is TaskStatus;
+/**
+ * Check if a value is a valid TaskPriority
+ *
+ * @param value - Value to check
+ * @returns True if valid TaskPriority
+ */
+export declare function isValidTaskPriority(value: string): value is TaskPriority;
+/**
+ * Check if a value is a valid ConversationSource
+ *
+ * @param value - Value to check
+ * @returns True if valid ConversationSource
+ */
+export declare function isValidConversationSource(value: string): value is ConversationSource;
+//# sourceMappingURL=orchestrator-state.types.d.ts.map

package/dist/cli/backend/src/types/orchestrator-state.types.d.ts.map

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

package/dist/cli/backend/src/types/orchestrator-state.types.js

@@ -0,0 +1,110 @@
+/**
+ * Orchestrator State Persistence Types
+ *
+ * Types for saving and restoring orchestrator state across
+ * restarts, enabling continuous operation and self-improvement.
+ *
+ * @module types/orchestrator-state
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * State file paths configuration
+ */
+export const STATE_PATHS = {
+    STATE_DIR: '.crewly/state',
+    CURRENT_STATE: 'orchestrator-state.json',
+    BACKUP_DIR: 'backups',
+    SELF_IMPROVEMENT_DIR: 'self-improvement',
+};
+/**
+ * State version for migrations
+ */
+export const STATE_VERSION = '1.0.0';
+/**
+ * Maximum messages to persist per conversation
+ */
+export const MAX_PERSISTED_MESSAGES = 50;
+/**
+ * Checkpoint interval in milliseconds (1 minute)
+ */
+export const CHECKPOINT_INTERVAL_MS = 60000;
+/**
+ * Valid orchestrator modes array — single source of truth for runtime
+ * validation and the type guard below.
+ */
+export const ORCHESTRATOR_MODES = [
+    'normal',
+    'onboarding',
+    'onboarding-provisioning',
+];
+/**
+ * Default orchestrator mode used when state is freshly initialized or
+ * round-tripped from an older state file that predates the `mode` field.
+ */
+export const DEFAULT_ORCHESTRATOR_MODE = 'normal';
+/**
+ * Valid checkpoint reasons array
+ */
+export const CHECKPOINT_REASONS = [
+    'scheduled',
+    'before_restart',
+    'task_completed',
+    'user_request',
+    'self_improvement',
+    'error_recovery',
+];
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if a value is a valid CheckpointReason
+ *
+ * @param value - Value to check
+ * @returns True if valid CheckpointReason
+ */
+export function isValidCheckpointReason(value) {
+    return CHECKPOINT_REASONS.includes(value);
+}
+/**
+ * Check if a value is a valid OrchestratorMode (Onboarding v3 — B2).
+ *
+ * Used by `state-persistence.service` when round-tripping a persisted
+ * state to fall back to `DEFAULT_ORCHESTRATOR_MODE` if the file contains
+ * a corrupted or future-unknown value. Narrows the input to the union.
+ *
+ * @param value - Value to check
+ * @returns True if valid OrchestratorMode
+ */
+export function isValidOrchestratorMode(value) {
+    return typeof value === 'string' && ORCHESTRATOR_MODES.includes(value);
+}
+/**
+ * Check if a value is a valid TaskStatus
+ *
+ * @param value - Value to check
+ * @returns True if valid TaskStatus
+ */
+export function isValidTaskStatus(value) {
+    return ['pending', 'in_progress', 'blocked', 'paused', 'completed'].includes(value);
+}
+/**
+ * Check if a value is a valid TaskPriority
+ *
+ * @param value - Value to check
+ * @returns True if valid TaskPriority
+ */
+export function isValidTaskPriority(value) {
+    return ['low', 'medium', 'high', 'critical'].includes(value);
+}
+/**
+ * Check if a value is a valid ConversationSource
+ *
+ * @param value - Value to check
+ * @returns True if valid ConversationSource
+ */
+export function isValidConversationSource(value) {
+    return ['chat', 'slack', 'api'].includes(value);
+}
+//# sourceMappingURL=orchestrator-state.types.js.map

package/dist/cli/backend/src/types/orchestrator-state.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-state.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/orchestrator-state.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,eAAe;IAC1B,aAAa,EAAE,yBAAyB;IACxC,UAAU,EAAE,SAAS;IACrB,oBAAoB,EAAE,kBAAkB;CAChC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AA8B5C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,QAAQ;IACR,YAAY;IACZ,yBAAyB;CACjB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB,QAAQ,CAAC;AAiBpE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,gBAAgB;CACjB,CAAC;AA0gBF,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAyB,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAyB,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/cli/backend/src/types/v2/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * V2 Core Types — Barrel Export
+ *
+ * Central export point for all V2 architecture types.
+ * Import from this module for convenience:
+ *
+ * @example
+ * ```typescript
+ * import { Request, WorkItem, Trigger, ReconcileResult, TaskClaim } from '../types/v2/index.js';
+ * ```
+ *
+ * @module types/v2
+ */
+export type { Request, RequestStatus, IntentCategory, IntentLevel, CreateRequestInput, UpdateRequestInput, } from './request.types.js';
+export { REQUEST_STATUSES, TERMINAL_REQUEST_STATUSES, INTENT_CATEGORIES, REQUEST_TRANSITIONS, isValidRequestStatus, isValidIntentCategory, isValidRequestTransition, isRequest, validateCreateRequestInput, createRequest, } from './request.types.js';
+export type { WorkItem, WorkItemType, WorkItemOwner, WorkItemStatus, CreateWorkItemInput, UpdateWorkItemInput, } from './work-item.types.js';
+export { WORK_ITEM_TYPES, WORK_ITEM_OWNERS, WORK_ITEM_STATUSES, TERMINAL_WORK_ITEM_STATUSES, WORK_ITEM_TRANSITIONS, DEFAULT_MAX_RETRIES, isValidWorkItemType, isValidWorkItemStatus, isValidWorkItemOwner, isValidWorkItemTransition, isWorkItem, validateCreateWorkItemInput, createWorkItem, LAST_REQUEUED_AT_METADATA_KEY, getTtlAnchorAt, } from './work-item.types.js';
+export type { Trigger, TriggerType, TriggerStatus, TriggerConfig, TimeTriggerConfig, SignalTriggerConfig, CompoundTriggerConfig, TriggerAction, CreateTriggerInput, } from './trigger.types.js';
+export { TRIGGER_TYPES, TRIGGER_STATUSES, DEFAULT_MAX_IDLE_FIRES, isValidTriggerType, isValidTriggerStatus, isValidTriggerConfig, isTrigger, isValidTriggerAction, validateCreateTriggerInput, createTrigger, } from './trigger.types.js';
+export type { ReconcileResult, ReconcileType, ReconcileCorrection, ReconcilerConfig, ReconcilerStatus, WakeAction, WakeStrategy, AgentScoreBreakdown, } from './reconcile.types.js';
+export { RECONCILE_TYPES, DEFAULT_RECONCILER_CONFIG, isValidReconcileType, isReconcileResult, isValidReconcilerConfig, createEmptyReconcileResult, createCorrection, } from './reconcile.types.js';
+export type { TaskClaim, ClaimStatus, CreateClaimInput, } from './claim.types.js';
+export { CLAIM_STATUSES, DEFAULT_LEASE_DURATION_MS, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_GRACE_PERIOD_MS, DEFAULT_MAX_EXTENSIONS, isValidClaimStatus, isTaskClaim, isLeaseExpired, isGracePeriodExceeded, canExtendLease, validateCreateClaimInput, createTaskClaim, extendClaim, } from './claim.types.js';
+export type { Mission, MissionStatus, MissionPolicy, EscalationRule, EscalationCondition, EscalationAction, EscalationTarget, PolicyAction, PolicyDecision, EscalationContext, CreateMissionInput, UpdateMissionInput, UpdatePolicyInput, PhaseGateApproval, WorkHoursWindow, ExecutionCadence, MissionLevel, ProposalState, ApprovalState, } from './mission.types.js';
+export { MISSION_STATUSES, TERMINAL_MISSION_STATUSES, MISSION_TRANSITIONS, POLICY_ACTIONS, ESCALATION_CONDITIONS, ACTION_TO_POLICY_FIELD, CONSERVATIVE_POLICY, MODERATE_POLICY, AUTONOMOUS_POLICY, PHASE_GATE_APPROVALS, CONSERVATIVE_CADENCE, MODERATE_CADENCE, AUTONOMOUS_CADENCE, isValidMissionStatus, isValidPolicyAction, isValidEscalationCondition, isValidMissionTransition, isValidEscalationRule, isValidPhaseGateApproval, isValidWorkHoursWindow, isValidExecutionCadence, isValidMissionPolicy, isMission, createMissionPolicy, createMission, getEffectiveCadence, mergeExecutionCadence, MISSION_LEVELS, MISSION_LEVEL_DEPTH, PROJECT_LEVEL_DEPTH, PROPOSAL_STATES, PROPOSAL_TRANSITIONS, isValidMissionLevel, validateLevelLink, deriveLevel, isValidProposalState, isValidProposalTransition, validateCascadeLink, } from './mission.types.js';
+export type { KeyResult, KRMetricType, KRStatus, KRMeasurementSource, KRContribution, KRMeasurement, CreateKeyResultInput, UpdateKeyResultInput, MissionOKRSummary, CascadeOKRSummary, OKRRecommendation, OKRReviewResult, ReviewDecision, } from './key-result.types.js';
+export { KR_METRIC_TYPES, KR_STATUSES, KR_MEASUREMENT_SOURCES, MAX_MEASUREMENT_HISTORY, isValidKRMetricType, isValidKRStatus, isValidKRMeasurementSource, isKeyResult, validateCreateKeyResultInput, createKeyResult, computeKRProgress, deriveKRStatus, deriveOKRRecommendation, computeRolledUpProgress, } from './key-result.types.js';
+export type { Workspace, WorkspaceAccessMode, WorkspaceOwnerType, CreateWorkspaceInput, WriteWorkspaceInput, StructuredWriteInput, } from './workspace.types.js';
+export { WORKSPACE_ACCESS_MODES, WORKSPACE_OWNER_TYPES, isValidWorkspaceAccessMode, isValidWorkspaceOwnerType, isWorkspace, validateCreateWorkspaceInput, validateWriteWorkspaceInput, createWorkspace, WorkspaceConflictError, WorkspaceAccessError, } from './workspace.types.js';
+//# sourceMappingURL=index.d.ts.map