@moorline/core 0.0.1

package/dist/types/app.d.ts

@@ -0,0 +1,444 @@
+import type { RuntimeProviderDiagnostics } from './provider.js';
+import type { RuntimeModeName } from './runtime.js';
+import type { RuntimeSurfaceState } from './config.js';
+import type { HistoryEntry, HistoryStatus } from './history.js';
+import type { JsonSchemaLike, PackageApplyPlan, PackageCatalogEntry, PackageKind, PackageSurface } from './package.js';
+import type { RuntimeManagementContribution } from './plugin.js';
+import type { MoorlineReleaseManifest, MoorlineRuntimeMode, RuntimePackageLoadFailure } from './release.js';
+export interface RuntimeControlStatus {
+    acceptingNewWork: boolean;
+    supervised: boolean;
+}
+export type SidecarScopeKind = 'global' | 'session' | 'ephemeral';
+export type SidecarRestartPolicy = 'never' | 'on-failure';
+export type ManagedObjectKind = 'session' | 'mission' | 'plugin' | 'skill' | 'service' | 'pending_request' | 'provider_thread' | 'sidecar';
+export type ManagedObjectTrustLevel = 'official' | 'local' | 'operator';
+export interface ManagedObjectMutability {
+    editable: boolean;
+    installable: boolean;
+    removable: boolean;
+}
+export interface ManagedObjectTrust {
+    level: ManagedObjectTrustLevel;
+    source: string;
+}
+export interface ManagedObjectSourceOfTruth {
+    kind: 'sqlite' | 'filesystem' | 'runtime' | 'provider' | 'transport';
+    label: string;
+    path?: string;
+}
+export interface ManagedObjectRuntimeState {
+    status: string;
+    updatedAt: string | null;
+    details?: Record<string, unknown>;
+}
+export interface ManagedObjectBase {
+    id: string;
+    kind: ManagedObjectKind;
+    name: string;
+    summary: string | null;
+    controls: string[];
+    mutability: ManagedObjectMutability;
+    trust: ManagedObjectTrust;
+    sourceOfTruth: ManagedObjectSourceOfTruth;
+    runtimeState: ManagedObjectRuntimeState;
+}
+export interface ManagementSessionOwner {
+    kind: string;
+    id: string;
+    label: string | null;
+}
+export interface ManagedSessionRecord extends ManagedObjectBase {
+    spaceId: string;
+    threadId: string;
+    lifecycleStatus: 'hot' | 'cool' | 'archived';
+    runtimeMode: RuntimeModeName;
+    objective: string | null;
+    tags: string[];
+    owner: ManagementSessionOwner | null;
+    waitState: 'idle' | 'running' | 'waiting_for_approval' | 'waiting_for_input' | 'completed' | 'failed' | 'interrupted' | 'cancelled';
+    providerStatus: string | null;
+    pendingRequestCount: number;
+    recentActivityCount: number;
+}
+export interface ManagedMissionRecord extends ManagedObjectBase {
+    spaceId: string;
+    threadId: string;
+    lifecycleStatus: string;
+    runtimeMode: RuntimeModeName;
+    goal: string;
+    scheduleText: string;
+    nextRunAt: string | null;
+    lastRunAt: string | null;
+    pausedAt: string | null;
+    archivedAt: string | null;
+}
+export interface ManagedPluginRecord extends ManagedObjectBase {
+    pluginId: string;
+    version: string;
+    pluginType: string;
+    capabilities: string[];
+    hooks: string[];
+    commands: string[];
+    packageGroup: 'official' | 'local';
+}
+export interface ManagedSkillRecord extends ManagedObjectBase {
+    skillName: string;
+    tags: string[];
+    metadata: Record<string, string | string[]>;
+}
+export interface ManagedServiceRecord extends ManagedObjectBase {
+    serviceType: 'runtime' | 'transport' | 'provider' | 'management' | 'storage' | 'audit';
+}
+export interface ManagedPendingRequestRecord extends ManagedObjectBase {
+    threadId: string;
+    spaceId: string;
+    requestType: string;
+    requesterUserId: string | null;
+    createdAt: string;
+    detail: string | null;
+    questions: Array<{
+        id: string;
+        header: string;
+        question: string;
+        options: Array<{
+            label: string;
+            description: string;
+        }>;
+    }>;
+}
+export interface ManagedProviderThreadRecord extends ManagedObjectBase {
+    threadId: string;
+    spaceId: string | null;
+    providerThreadId: string | null;
+    runtimeMode: RuntimeModeName;
+    model: string | null;
+}
+export interface ManagedSidecarSummary extends ManagedObjectBase {
+    pluginId: string;
+    scopeKind: SidecarScopeKind;
+    scopeKey: string;
+    command: string;
+    args: string[];
+    restartPolicy: SidecarRestartPolicy;
+    restartCount: number;
+    pid: number | null;
+    startedAt: string | null;
+    readyAt: string | null;
+    stoppedAt: string | null;
+    lastError: string | null;
+}
+export interface ManagementSettingsContract {
+    defaults: {
+        runtimeMode: 'full-access' | 'approval-required';
+        model: string;
+    };
+    transport: {
+        kind: string;
+        packageId?: string;
+        scopeId: string;
+        applicationId: string;
+        actorId: string;
+        invitePermissions: string;
+    };
+    provider: {
+        kind: string;
+        packageId?: string;
+        config: Record<string, unknown>;
+    };
+    admin: {
+        explicitAccessGroupCount: number;
+        explicitUserCount: number;
+        allowTransportAdmin: boolean;
+        managedRole: {
+            enabled: boolean;
+            name: string;
+        };
+        managedUserRole: {
+            enabled: boolean;
+            name: string;
+        };
+    };
+}
+export interface ManagementApiTrustContract {
+    authMode: 'bearer-token';
+    loopbackOnly: boolean;
+    tokenSource: 'local-connection-record' | 'operator-provided';
+    restartBehavior: 'adapter-restart-required';
+}
+export interface ManagementApiDeliveryTrack {
+    id: 'install' | 'onboarding' | 'lifecycle' | 'trust' | 'updates' | 'app_shell';
+    title: string;
+    summary: string;
+    status: 'implemented' | 'defined';
+}
+export interface ManagementApiRecoveryAction {
+    need: string;
+    localAction: string;
+    fallback: string;
+}
+export interface ManagementApiContract {
+    readableResources: string[];
+    writableActions: string[];
+    trust: ManagementApiTrustContract;
+    navigation: string[];
+    deliveryTracks: ManagementApiDeliveryTrack[];
+    recoveryActions: ManagementApiRecoveryAction[];
+}
+export interface ManagementInstallContract {
+    packageTargets: Array<{
+        platform: 'macos' | 'windows' | 'linux';
+        format: string;
+        launcher: string;
+        autoOpenLocalUi: boolean;
+    }>;
+    installedComponents: string[];
+    uninstallBehavior: string;
+}
+export interface ManagementOnboardingContract {
+    steps: string[];
+    requiredInputs: string[];
+    prerequisiteChecks: string[];
+    completionState: string;
+}
+export interface ManagementLifecycleContract {
+    clientDisconnectBehavior: string;
+    runtimeStopBehavior: string;
+    startAtLogin: 'planned' | 'manual';
+    backgroundMode: string;
+    failureRecovery: string;
+}
+export interface ManagementUpdateContract {
+    appUpdates: string;
+    officialPackageUpdates: string;
+    localPackageHandling: string;
+    operatorTrigger: string;
+}
+export interface ManagementProviderAlignment {
+    status: 'aligned' | 'partial';
+    supportedCapabilities: string[];
+    supportedMethods: string[];
+    surfacedManagementAreas: string[];
+    intentionalLimits: string[];
+}
+export interface ManagementOrchestrationHealthRecord {
+    openRequests: number;
+    runningRequests: number;
+    pendingRequests: number;
+    staleRunningRequests: number;
+    oldestOpenAgeMs: number;
+    oldestRunningAgeMs: number;
+    inFlightRequests: number;
+    staleRunningThresholdMs: number;
+}
+export interface ManagementActiveTurnHealthRecord {
+    activeTurns: number;
+    staleActiveTurns: number;
+    oldestActiveTurnAgeMs: number;
+    staleActiveTurnThresholdMs: number;
+}
+export interface ManagementRuntimeWorkerQueueHealthRecord {
+    name: string;
+    pendingTotal: number;
+    keysWithPending: number;
+    maxPendingPerKey: number;
+    maxPendingTotal: number;
+    oldestPendingAgeMs: number;
+}
+export interface ManagementRuntimeRetentionHealthRecord {
+    lastPrunedAt: string;
+    policy: {
+        runtimeEventTtlMs: number;
+        domainEventTtlMs: number;
+        resolvedRequestTtlMs: number;
+        orchestrationTtlMs: number;
+        imageTtlMs: number;
+    };
+    stats: {
+        runtimeEventsDeleted: number;
+        domainEventsDeleted: number;
+        resolvedRequestsDeleted: number;
+        closedOrchestrationRequestsDeleted: number;
+        removedInputImageFiles: number;
+        removedInputImageDirectories: number;
+    };
+}
+export interface ManagementReadModelPresentation {
+    productDirection: string;
+    setupReadyNextAction: string;
+    setupIncompleteNextAction: string;
+    contract: ManagementApiContract;
+    delivery: {
+        install: ManagementInstallContract;
+        onboarding: ManagementOnboardingContract;
+        lifecycle: ManagementLifecycleContract;
+        updates: ManagementUpdateContract;
+    };
+}
+export type ManagementPackageCatalogEntry = PackageCatalogEntry;
+export interface ManagementInstalledPackageRecord {
+    kind: PackageKind;
+    surface: PackageKind;
+    packageId: string;
+    name: string;
+    version: string;
+    description: string | null;
+    installedAt: string;
+    installPath: string;
+    sourceLabel: string;
+    dependencies: string[];
+    members?: string[];
+    installedByPackageIds?: string[];
+    selected: boolean;
+    enabled: boolean;
+    activationState: 'activated' | 'deactivated';
+    activationUniqueKey: string | null;
+}
+export interface ManagementPackageConfigField {
+    key: string;
+    title: string;
+    description: string | null;
+    type: 'string' | 'boolean' | 'number';
+    required: boolean;
+    secret: boolean;
+    defaultValue: string | boolean | number | null;
+    enumValues: Array<string | boolean | number>;
+    value: string | boolean | number | null;
+    configured: boolean;
+}
+export interface ManagementPackageConfigRecord {
+    surface: PackageSurface;
+    packageId: string;
+    selected: boolean;
+    enabled: boolean;
+    active: boolean;
+    activationState: 'activated' | 'deactivated';
+    activationUniqueKey: string | null;
+    schema: JsonSchemaLike | null;
+    fields: ManagementPackageConfigField[];
+}
+export interface ManagementReadModel {
+    generatedAt: string;
+    product: {
+        runtimeName: 'Moorline';
+        managementName: 'Moorline';
+        direction: string;
+    };
+    contract: ManagementApiContract;
+    delivery: {
+        install: ManagementInstallContract;
+        onboarding: ManagementOnboardingContract;
+        lifecycle: ManagementLifecycleContract;
+        updates: ManagementUpdateContract;
+    };
+    setup: {
+        runtimeRoot: string;
+        installationStatePath: string;
+        namespaceBootstrapped: boolean;
+        providerConnected: boolean;
+        readyForSessions: boolean;
+        nextAction: string;
+        completed: boolean;
+    };
+    settings: ManagementSettingsContract;
+    namespace: RuntimeSurfaceState | null;
+    runtime: {
+        status: ReturnType<ManagementRuntimeStatusProvider>;
+        control: RuntimeControlStatus;
+        release: {
+            mode: MoorlineRuntimeMode;
+            assetRoot: string;
+            manifest: MoorlineReleaseManifest;
+        };
+        managementSurface: {
+            enabled: boolean;
+            host: string;
+            port: number;
+            url: string | null;
+            authMode: 'bearer-token';
+        };
+    };
+    provider: {
+        diagnostics: RuntimeProviderDiagnostics;
+        alignment: ManagementProviderAlignment;
+    };
+    packages: {
+        catalog: ManagementPackageCatalogEntry[];
+        installed: ManagementInstalledPackageRecord[];
+        config: ManagementPackageConfigRecord[];
+        applyPlan: PackageApplyPlan;
+    };
+    diagnostics: {
+        auditLogPath: string;
+        exportFormats: string[];
+        runtimeHealth: {
+            orchestration: ManagementOrchestrationHealthRecord;
+            activeTurns: ManagementActiveTurnHealthRecord;
+            pruning?: ManagementRuntimeRetentionHealthRecord;
+            workerQueues?: ManagementRuntimeWorkerQueueHealthRecord[];
+        };
+        packageLoadFailures: RuntimePackageLoadFailure[];
+        configMigrationWarning: {
+            type: 'secret_history_reset';
+            createdAt: string;
+            backupGitDir: string | null;
+            detail: string;
+        } | null;
+        recentAuditEvents: Array<{
+            eventType: string;
+            actor: string;
+            action: string;
+            status: string;
+            target: string | null;
+            reason: string | null;
+            recordedAt: string | null;
+        }>;
+        recentRuntimeActivities: Array<{
+            kind: string;
+            severity: 'info' | 'warning' | 'error';
+            title: string;
+            detail: string | null;
+            threadId: string;
+            spaceId: string | null;
+            createdAt: string;
+        }>;
+    };
+    history: {
+        status: HistoryStatus;
+        entries: HistoryEntry[];
+        capabilities: {
+            snapshot: boolean;
+            restore: boolean;
+            discard: boolean;
+        };
+    };
+    overview: {
+        sessions: number;
+        missions: number;
+        pendingRequests: number;
+        plugins: number;
+        skills: number;
+        services: number;
+        providerThreads: number;
+        sidecars: number;
+    };
+    objects: {
+        sessions: ManagedSessionRecord[];
+        missions: ManagedMissionRecord[];
+        plugins: ManagedPluginRecord[];
+        skills: ManagedSkillRecord[];
+        services: ManagedServiceRecord[];
+        managementContributions: RuntimeManagementContribution[];
+        pendingRequests: ManagedPendingRequestRecord[];
+        providerThreads: ManagedProviderThreadRecord[];
+        sidecars: ManagedSidecarSummary[];
+    };
+}
+export type ManagementRuntimeStatusProvider = () => {
+    uptimeSeconds: number;
+    openSessions: number;
+    coolSessions: number;
+    archivedSessions: number;
+    waitingSessions: number;
+    runningSessions: number;
+};

package/dist/types/app.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app.js.map

package/dist/types/app.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,188 @@
+import type { PackageKind, PackageSourceDescriptor } from './package.js';
+export type MoorlineConfigVersion = 4;
+export declare const CURRENT_MOORLINE_CONFIG_VERSION: MoorlineConfigVersion;
+export declare const DEFAULT_MOORLINE_MODEL = "latest";
+export type ExecutionModeName = 'full-access' | 'approval-required';
+export interface RuntimeSurfaceNames {
+    mainCategoryName: string;
+    chatChannelName: string;
+    statusChannelName: string;
+    sessionsCategoryName: string;
+    missionsCategoryName: string;
+    archiveCategoryName: string;
+}
+export interface TransportConfig {
+    kind: string;
+    packageId?: string;
+    authToken: string;
+    scopeId: string;
+    applicationId: string;
+    actorId: string;
+    invitePermissions: string;
+}
+export interface ProviderConfig {
+    kind: string;
+    packageId?: string;
+    command?: string;
+}
+export declare const DEFAULT_MOORLINE_ADMIN_ROLE_NAME = "Moorline Admin";
+export declare const DEFAULT_MOORLINE_USER_ROLE_NAME = "Moorline User";
+export interface ManagedAdminRoleConfig {
+    enabled: boolean;
+    name: string;
+}
+export interface ManagedUserRoleConfig {
+    enabled: boolean;
+    name: string;
+}
+export interface AdminConfig {
+    accessGroupIds: string[];
+    userIds: string[];
+    allowTransportAdmin?: boolean;
+    managedRole: ManagedAdminRoleConfig;
+    managedUserRole: ManagedUserRoleConfig;
+}
+type ManagementExposureMode = 'loopback' | 'remote';
+type ManagementAuthMode = 'bearer';
+interface LocalManagementAuthConfig {
+    mode: ManagementAuthMode;
+}
+interface LocalManagementTlsConfig {
+    enabled: boolean;
+    certPath?: string;
+    keyPath?: string;
+}
+export interface LocalManagementConfig {
+    enabled: boolean;
+    host: string;
+    port: number;
+    exposure?: ManagementExposureMode;
+    auth?: LocalManagementAuthConfig;
+    tls?: LocalManagementTlsConfig;
+}
+export type ControlApiConfig = LocalManagementConfig;
+export type MainLifecyclePolicy = 'detached' | 'stop_on_last_lease';
+export interface MainProcessConfig {
+    autostart: boolean;
+    defaultLifecyclePolicy: MainLifecyclePolicy;
+}
+export interface SurfaceSelectionState {
+    activePackageId: string | null;
+    config: Record<string, unknown>;
+    configByPackageId?: Record<string, Record<string, unknown>>;
+}
+export interface SurfaceEnablementState {
+    enabledPackageIds: string[];
+    configByPackageId: Record<string, Record<string, unknown>>;
+}
+export interface MoorlineSetupState {
+    completed: boolean;
+    completedAt?: string;
+}
+export interface MoorlineSecrets {
+    version: 1;
+    surfaces: {
+        apiAdapter: {
+            config: Record<string, unknown>;
+            configByPackageId: Record<string, Record<string, unknown>>;
+        };
+        transport: {
+            config: Record<string, unknown>;
+            configByPackageId: Record<string, Record<string, unknown>>;
+        };
+        provider: {
+            config: Record<string, unknown>;
+            configByPackageId: Record<string, Record<string, unknown>>;
+        };
+        plugins: {
+            configByPackageId: Record<string, Record<string, unknown>>;
+        };
+        skills: {
+            configByPackageId: Record<string, Record<string, unknown>>;
+        };
+    };
+}
+export interface MoorlineShareBundle {
+    version: 1;
+    exportedAt: string;
+    productVersion: string;
+    config: MoorlineConfig;
+    packages: {
+        selectedApiAdapterPackageId: string | null;
+        selectedTransportPackageId: string | null;
+        selectedProviderPackageId: string | null;
+        enabledPluginPackageIds: string[];
+        enabledSkillPackageIds: string[];
+        installed: Array<{
+            kind?: PackageKind;
+            surface: PackageKind;
+            packageId: string;
+            source: PackageSourceDescriptor | null;
+            shareState: 'portable' | 'local_only' | 'missing_source';
+        }>;
+    };
+    notes: string[];
+}
+export interface MoorlineConfig {
+    version: MoorlineConfigVersion;
+    runtimeRoot: string;
+    transport?: TransportConfig;
+    provider?: ProviderConfig;
+    admin?: AdminConfig;
+    main?: MainProcessConfig;
+    defaults: {
+        runtimeMode: ExecutionModeName;
+        model: string;
+    };
+    surface: RuntimeSurfaceNames;
+    setup: MoorlineSetupState;
+    surfaces: {
+        apiAdapter: SurfaceSelectionState;
+        transport: SurfaceSelectionState;
+        provider: SurfaceSelectionState;
+        plugins: SurfaceEnablementState;
+        skills: SurfaceEnablementState;
+    };
+}
+export type AppliedMoorlineConfig = MoorlineConfig & {
+    transport: TransportConfig;
+    provider: ProviderConfig;
+    main: MainProcessConfig;
+    namespace: RuntimeSurfaceNames;
+};
+export interface RuntimeSurfaceState {
+    scopeId?: string;
+    mainCategoryId: string;
+    chatChannelId: string;
+    statusChannelId: string;
+    sessionsCategoryId: string;
+    missionsCategoryId: string;
+    archiveCategoryId: string;
+    adminAccessGroupId?: string;
+    memberAccessGroupId?: string;
+    adminAccessGroupName?: string;
+    memberAccessGroupName?: string;
+    adminAccessGroupVerifiedAt?: string;
+    memberAccessGroupVerifiedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type ManagedNamespaceState = RuntimeSurfaceState;
+export declare function defaultMoorlineHomePath(): string;
+export declare function defaultMoorlineRuntimeRoot(): string;
+export declare function homeRootForRuntime(runtimeRoot: string): string;
+export declare function formatManagementHttpUrl(host: string, port: number): string;
+export declare function normalizeManagementOrigin(value: string): string | null;
+export declare function defaultNamespaceNames(): RuntimeSurfaceNames;
+export declare function defaultAdminConfig(): AdminConfig;
+export declare function defaultManagementConfig(): LocalManagementConfig;
+export declare function defaultHttpApiAdapterConfig(): ControlApiConfig;
+export declare function parseHttpApiAdapterConfig(config: Record<string, unknown>): ControlApiConfig;
+export declare function selectedApiAdapterPackageConfig(config: MoorlineConfig, packageId?: string | null): Record<string, unknown>;
+export declare function defaultMainProcessConfig(): MainProcessConfig;
+export declare function defaultTransportPackageId(kind: string): string;
+export declare function defaultProviderPackageId(kind: string): string;
+export declare function usesProviderDefaultModel(model: string): boolean;
+export declare function parseMoorlineConfig(input: unknown): MoorlineConfig;
+export declare function configuredApiAdapterConfig(config: MoorlineConfig, packageId?: string): ControlApiConfig;
+export {};