@moorline/contracts 0.0.1

package/dist/plugin-runtime.d.ts

@@ -0,0 +1,575 @@
+import type { Capability } from './capabilities.js';
+import type { PluginManifest, RuntimeManagementContribution } from './plugin.js';
+import type { RuntimeProviderTestResult } from './provider.js';
+import type { RuntimeActionDefinition, RuntimeActorIdentity, RuntimeAttachmentPayload, RuntimeMessagePayload, RuntimeSurfaceState, RuntimeTransportEvent } from './transport.js';
+import type { PendingRuntimeRequestRecord, ProviderRuntimeEvent, ProviderSessionStatus, ProviderThreadTokenUsage, RuntimeModeName } from './runtime.js';
+export interface RuntimeDomainEvent {
+    eventId: string;
+    threadId: string;
+    spaceId?: string | null;
+    sessionId?: string | null;
+    missionId?: string | null;
+    sourceProviderEventId?: string | null;
+    createdAt: string;
+    type: string;
+    payload?: unknown;
+}
+export interface RuntimeActionDispatchResult {
+    handled: boolean;
+    reply?: RuntimeMessagePayload;
+    audit?: {
+        event: string;
+        payload?: Record<string, unknown>;
+    };
+    continueDispatch?: boolean;
+}
+export interface RuntimeToolResult {
+    content: string;
+}
+export interface SkillCatalogEntry {
+    name: string;
+    description?: string;
+    tags?: string[];
+}
+export interface LoadedSkill extends SkillCatalogEntry {
+    body?: string;
+}
+export interface WrittenSkillResult {
+    skillDir: string;
+    skillPath: string;
+    resourcePaths: string[];
+}
+export type RuntimeEntityRecord = {
+    id?: string;
+    sessionId?: string;
+    missionId?: string;
+    runId?: string;
+    threadId?: string;
+    spaceId?: string;
+    name?: string;
+    title?: string;
+    status?: string;
+    lifecycleStatus?: string;
+    runtimeMode?: RuntimeModeName;
+};
+export type SessionLifecycleStatus = 'hot' | 'cool' | 'archived';
+export type RuntimeSessionRow = RuntimeEntityRecord & {
+    sessionId: string;
+    scopeId: string;
+    threadId: string;
+    spaceId: string;
+    spaceName: string;
+    workspacePath: string;
+    summary: string | null;
+    provider: string;
+    providerThreadId: string | null;
+    resumeThreadId: string | null;
+    providerStatus: ProviderSessionStatus;
+    activeTurnId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastActivityAt: string;
+    archivedAt: string | null;
+    lastError: string | null;
+    lifecycleStatus: SessionLifecycleStatus;
+    runtimeMode: RuntimeModeName;
+};
+export type RuntimeMissionRow = RuntimeEntityRecord & {
+    missionId: string;
+    title: string;
+    spaceId: string;
+};
+export type RuntimeMissionRunRow = RuntimeEntityRecord & {
+    runId: string;
+    missionId: string;
+};
+export type RuntimeMissionHookBindingRow = RuntimeEntityRecord & {
+    bindingId: string;
+    missionId: string;
+    hookKey: string;
+};
+export interface RuntimeReceiptRecord {
+    threadId: string;
+    sessionId: string | null;
+    spaceId: string | null;
+    state: string;
+    updatedAt: string;
+}
+export interface RuntimeActivityRecord {
+    id?: string;
+    threadId?: string;
+    type?: string;
+    createdAt?: string;
+}
+export interface RuntimeProviderConnectionSnapshot {
+    threadId: string;
+    providerPackageId: string;
+    runtimeMode: RuntimeModeName;
+    workspacePath: string;
+    providerThreadId: string | null;
+    status: ProviderSessionStatus;
+    model: string | null;
+    accountLabel: string | null;
+    availableModels: string[];
+    updatedAt: string;
+    lastError: string | null;
+    tokenUsage?: ProviderThreadTokenUsage;
+    capabilityMetadata: Record<string, unknown>;
+}
+export interface RuntimeSessionSnapshot {
+    session: RuntimeSessionRow;
+    receipt: RuntimeReceiptRecord | null;
+    provider: RuntimeProviderConnectionSnapshot | null;
+    pendingRequests: PendingRuntimeRequestRecord[];
+    recentActivities: RuntimeActivityRecord[];
+}
+export interface RuntimeOverviewSnapshot {
+    sessions: RuntimeSessionSnapshot[];
+    receipts: RuntimeReceiptRecord[];
+    providers: RuntimeProviderConnectionSnapshot[];
+    projectionStates: Array<{
+        projector: string;
+        lastEventId: string | null;
+        lastAppliedAt: string;
+        failure: string | null;
+    }>;
+    openRequests: PendingRuntimeRequestRecord[];
+}
+export type RuntimeReloadMode = 'graceful' | 'force';
+export interface RuntimeControlStatus {
+    acceptingNewWork: boolean;
+    reloadInProgress?: boolean;
+    providerRunning?: boolean;
+}
+export interface RuntimeControlResult {
+    accepted: boolean;
+    detail?: string;
+}
+export interface ProviderControlResult {
+    ok: boolean;
+    action: 'start' | 'stop';
+    scope: 'all' | 'thread';
+    threadId: string | null;
+    requestedCount: number;
+    affectedCount: number;
+    skippedCount: number;
+    failures: Array<{
+        threadId: string;
+        error: string;
+    }>;
+    message: string;
+    remediation?: string;
+}
+export type SessionInventoryScope = 'active' | 'archived' | 'all' | string;
+export type SidecarScopeKind = 'global' | 'session' | 'ephemeral';
+export type SidecarReadinessProbe = {
+    kind: 'none';
+} | {
+    kind: 'stdio';
+    pattern: string;
+    stream?: 'stdout' | 'stderr' | 'both';
+    timeoutMs?: number;
+};
+export type ManagedSidecarScope = {
+    kind: 'global';
+} | {
+    kind: 'session';
+    key: string;
+} | {
+    kind: 'ephemeral';
+    key: string;
+};
+export interface ManagedSidecarLaunchSpec {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    restart?: {
+        policy?: 'never' | 'on-failure';
+        maxRestarts?: number;
+    };
+    readiness?: SidecarReadinessProbe;
+}
+export interface ManagedSidecarDefinition {
+    name: string;
+    scope: ManagedSidecarScope;
+    launch: ManagedSidecarLaunchSpec;
+}
+export interface ManagedSidecarRecord {
+    id?: string;
+    sidecarId?: string;
+    instanceId?: string;
+    pluginId?: string;
+    name: string;
+    scopeKind: SidecarScopeKind;
+    scopeKey: string;
+    status: string;
+}
+export type AgentSurface = 'main_chat' | 'session' | 'mission';
+export interface BeforeAgentPromptInput {
+    surface: AgentSurface;
+    spaceId: string;
+    actorId: string;
+    actorLabel: string;
+    text: string;
+    attachments?: RuntimeAttachmentPayload[];
+    session: RuntimeSessionRow | null;
+}
+export interface AfterAgentResponseInput extends BeforeAgentPromptInput {
+    replyMessage: string;
+}
+export interface CreatedSessionResult {
+    session: RuntimeSessionRow;
+    spaceId: string;
+}
+export type MissionHookCondition = Record<string, string | number | boolean | null>;
+export interface MissionHookDispatchResult {
+    hookKey: string;
+    source: string;
+    bindingCount: number;
+    matchedBindingCount: number;
+    triggeredMissionIds: string[];
+}
+export type ArchivedSpaceTarget = {
+    kind: 'session';
+    session: RuntimeSessionRow;
+} | {
+    kind: 'mission';
+    mission: RuntimeMissionRow;
+};
+export type SessionOwnerKind = 'mission' | 'run' | 'parent_session' | 'orchestrator';
+export interface SessionOwnerLink {
+    kind: SessionOwnerKind;
+    id: string;
+    label?: string;
+}
+export interface SessionQueryFilter {
+    scope?: SessionInventoryScope;
+    lifecycleStatuses?: RuntimeSessionRow['lifecycleStatus'][];
+    runtimeModes?: RuntimeModeName[];
+    ownerKind?: SessionOwnerKind;
+    ownerId?: string;
+    tag?: string;
+    objectiveText?: string;
+    waitStates?: Array<'idle' | 'running' | 'waiting_for_approval' | 'waiting_for_input' | 'completed' | 'failed' | 'interrupted' | 'cancelled'>;
+    includeArchived?: boolean;
+    limit?: number;
+}
+export interface RetrievedMemorySnippet {
+    id: string;
+    content: string;
+    sourceRefs: string[];
+    strategy: 'symbolic' | 'semantic' | 'metadata';
+}
+export interface RuntimePluginAdminConfig {
+    accessGroupIds: string[];
+    userIds: string[];
+    allowTransportAdmin?: boolean;
+    managedAdminAccessGroup: {
+        enabled: boolean;
+        name: string;
+    };
+    managedMemberAccessGroup: {
+        enabled: boolean;
+        name: string;
+    };
+}
+export type RuntimePluginConfig = object;
+export type RuntimePluginNamespaceState = RuntimeSurfaceState;
+export interface RuntimeToolContext {
+    readonly actorId: string;
+    readonly config: RuntimePluginConfig;
+    getCurrentSpaceId(): string;
+    getCurrentThreadId(): string;
+    getCurrentWorkspacePath(): string;
+    getChatWorkspacePath(): string;
+    listSkills(): SkillCatalogEntry[];
+    loadSkill(name: string): Promise<LoadedSkill | null>;
+    writeSkill(input: {
+        name: string;
+        description?: string;
+        tags?: string[];
+        body: string;
+        directoryName?: string;
+        resourceFiles?: Array<{
+            path: string;
+            content: string;
+        }>;
+    }): Promise<WrittenSkillResult>;
+    listSessions(): RuntimeSessionRow[];
+    getSessionBySpaceId(spaceId: string): RuntimeSessionRow | null;
+    getSessionById(sessionId: string): RuntimeSessionRow | null;
+    listMissions(): RuntimeMissionRow[];
+    getMissionBySpaceId(spaceId: string): RuntimeMissionRow | null;
+    getMissionById(missionId: string): RuntimeMissionRow | null;
+    listMissionRuns(missionId: string, limit?: number): RuntimeMissionRunRow[];
+    listMissionHookBindings(filter?: {
+        missionId?: string;
+        hookKey?: string;
+    }): RuntimeMissionHookBindingRow[];
+    bindMissionHook(input: {
+        missionId: string;
+        hookKey: string;
+        condition?: MissionHookCondition;
+    }): Promise<RuntimeMissionHookBindingRow>;
+    unbindMissionHook(input: {
+        bindingId: string;
+    }): Promise<RuntimeMissionHookBindingRow | null>;
+    emitMissionHook(input: {
+        hookKey: string;
+        payload?: Record<string, unknown>;
+        source?: string;
+    }): Promise<MissionHookDispatchResult>;
+    querySessions(filter?: SessionQueryFilter): RuntimeSessionSnapshot[];
+    createSession(input: {
+        requestedName: string;
+        runtimeMode: RuntimeModeName;
+        initialInstruction?: string;
+        objective?: string;
+        owner?: SessionOwnerLink;
+        tags?: string[];
+    }): Promise<CreatedSessionResult>;
+    directSession(input: {
+        sessionId?: string;
+        spaceId?: string;
+        instruction: string;
+        reason?: string;
+    }): Promise<{
+        session: RuntimeSessionRow;
+        reply: RuntimeMessagePayload;
+    }>;
+    archiveSession(input: {
+        spaceId: string;
+        sessionId?: string;
+    }): Promise<RuntimeSessionRow | null>;
+    deleteArchivedSession(input: {
+        spaceId: string;
+        sessionId?: string;
+    }): Promise<RuntimeSessionRow | null>;
+    createMission(input: {
+        title: string;
+        goal: string;
+        schedule: string;
+        startTime?: string;
+        runtimeMode: RuntimeModeName;
+    }): Promise<{
+        mission: RuntimeMissionRow;
+        spaceId: string;
+    }>;
+    pauseMission(input: {
+        spaceId: string;
+        missionId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    resumeMission(input: {
+        spaceId: string;
+        missionId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    stopMission(input: {
+        spaceId: string;
+        missionId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    runMissionNow(input: {
+        spaceId: string;
+        missionId?: string;
+        requesterActorId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    sendMessage(spaceId: string, payload: RuntimeMessagePayload): Promise<void>;
+    sendStatusUpdate(payload: RuntimeMessagePayload): Promise<void>;
+    appendAuditEvent(event: string, payload: Record<string, unknown>): void;
+    nowIso(): string;
+}
+export interface RuntimePluginAdminCapability {
+    getAdminConfig(): RuntimePluginAdminConfig;
+    isAdminActor(input: RuntimeActorIdentity): boolean;
+    getNamespaceState(): RuntimePluginNamespaceState;
+}
+export interface RuntimePluginObservabilityCapability {
+    listPendingRequests(spaceId: string): PendingRuntimeRequestRecord[];
+    listRuntimeReceipts(): RuntimeReceiptRecord[];
+    listProviderConnections(): RuntimeProviderConnectionSnapshot[];
+    listRuntimeActivities(threadId?: string): RuntimeActivityRecord[];
+    getSessionSnapshotBySpaceId(spaceId: string): RuntimeSessionSnapshot | null;
+    getSessionSnapshotById(sessionId: string): RuntimeSessionSnapshot | null;
+    getRuntimeOverview(): RuntimeOverviewSnapshot;
+    listProjectionStates(): Array<{
+        projector: string;
+        lastEventId: string | null;
+        lastAppliedAt: string;
+        failure: string | null;
+    }>;
+    getProviderDiagnostics(): {
+        accountLabel: string | null;
+        availableModels: string[];
+        connectedSessions: number;
+        statusCounts: Record<string, number>;
+        capabilityMetadata: Record<string, unknown>;
+    };
+    getDefaultModel(): string;
+    setDefaultModel(model: string): Promise<void>;
+    getRuntimeStatus(): {
+        uptimeSeconds: number;
+        openSessions: number;
+        coolSessions: number;
+        archivedSessions: number;
+        waitingSessions: number;
+        runningSessions: number;
+    };
+    listRuntimeEvents(threadId: string): ProviderRuntimeEvent[];
+    listDomainEvents(threadId: string): RuntimeDomainEvent[];
+    updateSessionSummary(spaceId: string, summary: string, nowIso: string): Promise<void>;
+}
+export interface RuntimePluginMemoryCapability {
+    retrieveMemory(input: {
+        query: string;
+        scopeId: string;
+        spaceId?: string;
+        threadId?: string | null;
+        maxResults?: number;
+        enableRerank?: boolean;
+    }): Promise<RetrievedMemorySnippet[]>;
+    writeSessionMemory(input: {
+        scopeId: string;
+        spaceId: string;
+        threadId?: string | null;
+        kind: 'log' | 'summary' | 'facts' | 'tasks';
+        content: string;
+        sourceRefs: string[];
+    }): Promise<void>;
+    writeServerMemory(input: {
+        scopeId: string;
+        kind: 'facts' | 'tasks';
+        content: string;
+        sourceRefs: string[];
+    }): Promise<void>;
+    writeProjectMemory(input: {
+        projectKey?: string;
+        kind: 'facts' | 'tasks';
+        content: string;
+        sourceRefs: string[];
+    }): Promise<void>;
+}
+export interface RuntimePluginWorkManagementCapability {
+    archiveMission(input: {
+        spaceId: string;
+        missionId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    deleteArchivedMission(input: {
+        spaceId: string;
+        missionId?: string;
+    }): Promise<RuntimeMissionRow | null>;
+    archiveSpaceTarget(input: {
+        spaceId: string;
+    }): Promise<ArchivedSpaceTarget | null>;
+    deleteArchivedSpaceTarget(input: {
+        spaceId: string;
+    }): Promise<ArchivedSpaceTarget | null>;
+    respondToRuntimeRequest(input: {
+        threadId: string;
+        requestId: string;
+        decision: 'accept' | 'decline' | 'cancel';
+        requesterActor?: RuntimeActorIdentity;
+    }): Promise<void>;
+    respondToRuntimeUserInput(input: {
+        threadId: string;
+        requestId: string;
+        answers: Record<string, string | string[]>;
+        requesterActor?: RuntimeActorIdentity;
+    }): Promise<void>;
+    cancelRuntimeRequest(input: {
+        threadId: string;
+        requestId: string;
+        requestType: PendingRuntimeRequestRecord['requestType'];
+        requesterActor?: RuntimeActorIdentity;
+    }): Promise<void>;
+    interruptTurn(input: {
+        threadId: string;
+    }): Promise<void>;
+}
+export interface RuntimePluginRuntimeControlCapability {
+    getRuntimeControlStatus(): RuntimeControlStatus;
+    requestRuntimeReload(input: {
+        mode: RuntimeReloadMode;
+        reason: string;
+        requestedBy: RuntimeActorIdentity;
+    }): Promise<RuntimeControlResult>;
+    setRuntimeAcceptingNewWork(input: {
+        accepting: boolean;
+        reason: string;
+        requestedBy: RuntimeActorIdentity;
+    }): Promise<void>;
+    testProvider(input: {
+        sendTurn?: boolean;
+        prompt?: string;
+        reason: string;
+        requestedBy: RuntimeActorIdentity;
+    }): Promise<RuntimeProviderTestResult>;
+    stopProvider(input: {
+        threadId?: string;
+        reason: string;
+        requestedBy: RuntimeActorIdentity;
+    }): Promise<ProviderControlResult>;
+    startProvider(input: {
+        threadId?: string;
+        reason: string;
+        requestedBy: RuntimeActorIdentity;
+    }): Promise<ProviderControlResult>;
+}
+export interface RuntimePluginSidecarCapability {
+    ensureSidecar(input: Omit<ManagedSidecarDefinition, 'pluginId'>): Promise<ManagedSidecarRecord>;
+    stopSidecar(input: {
+        name: string;
+        scopeKind: SidecarScopeKind;
+        scopeKey: string;
+    }): Promise<ManagedSidecarRecord | null>;
+    listSidecars(filter?: {
+        pluginId?: string;
+        scopeKind?: SidecarScopeKind;
+        scopeKey?: string;
+        status?: ManagedSidecarRecord['status'];
+    }): ManagedSidecarRecord[];
+}
+export interface RuntimePluginAgentCapability {
+    runAgent(input: {
+        surface: AgentSurface;
+        spaceId: string;
+        actorId: string;
+        actorLabel: string;
+        text: string;
+        attachments?: RuntimeAttachmentPayload[];
+        session: RuntimeSessionRow | null;
+        cwd: string;
+        runtimeMode: RuntimeModeName;
+        basePromptSections: string[];
+        promptSource?: string;
+    }): Promise<RuntimeMessagePayload>;
+    drainRuntimeWork(): Promise<void>;
+}
+export type RuntimePluginContext = RuntimeToolContext & RuntimePluginAdminCapability & RuntimePluginObservabilityCapability & RuntimePluginMemoryCapability & RuntimePluginWorkManagementCapability & RuntimePluginRuntimeControlCapability & RuntimePluginSidecarCapability & RuntimePluginAgentCapability;
+export interface RuntimeToolDefinition {
+    pluginId?: string;
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    requiredCapability?: Capability;
+    execute(input: Record<string, unknown>, context: RuntimeToolContext): Promise<RuntimeToolResult> | RuntimeToolResult;
+}
+export interface RuntimePlugin {
+    readonly id: string;
+    readonly manifest: PluginManifest;
+    actions?(context: RuntimePluginContext): RuntimeActionDefinition[];
+    managementContributions?(context: RuntimePluginContext): RuntimeManagementContribution[];
+    tools?(context: RuntimeToolContext): RuntimeToolDefinition[];
+    onRuntimeStarted?(context: RuntimePluginContext): Promise<void> | void;
+    onTransportEvent?(event: RuntimeTransportEvent, context: RuntimePluginContext): Promise<RuntimeActionDispatchResult | boolean | void> | RuntimeActionDispatchResult | boolean | void;
+    onAction?(event: Extract<RuntimeTransportEvent, {
+        type: 'action.invoked';
+    }>, context: RuntimePluginContext): Promise<RuntimeActionDispatchResult | boolean | void> | RuntimeActionDispatchResult | boolean | void;
+    onRuntimeEvent?(event: ProviderRuntimeEvent, context: RuntimePluginContext): Promise<void> | void;
+    beforeAgentPrompt?(input: BeforeAgentPromptInput, context: RuntimePluginContext): Promise<string[]> | string[];
+    afterAgentResponse?(input: AfterAgentResponseInput, context: RuntimePluginContext): Promise<void> | void;
+    onDomainEvent?(event: RuntimeDomainEvent, context: RuntimePluginContext): Promise<void> | void;
+    onRuntimeReceipt?(receipt: RuntimeReceiptRecord, context: RuntimePluginContext): Promise<void> | void;
+    onRuntimeActivity?(activity: RuntimeActivityRecord, context: RuntimePluginContext): Promise<void> | void;
+}
+export type RuntimeActionPlugin = RuntimePlugin;
+export type RuntimeToolPlugin = RuntimePlugin;

package/dist/plugin-runtime.js

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

package/dist/plugin-runtime.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+import type { JsonSchemaLike, PackageDependency, PackageManifestBase } from './package.js';
+import { type Capability } from './capabilities.js';
+import type { RuntimeActionDefinition } from './transport.js';
+export interface PluginManifest extends PackageManifestBase {
+    type: 'plugin';
+    entrypoint?: string;
+    priority?: number;
+    capabilities: Capability[];
+    hooks?: string[];
+    defaultEnabled?: boolean;
+    dependencies?: PackageDependency[];
+    configSchema?: JsonSchemaLike;
+    displayCategory?: string;
+}
+export interface RuntimeManagementContribution {
+    id: string;
+    title: string;
+    surface: 'cli';
+    packageId: string;
+    placement: 'overview' | 'control' | 'work' | 'packages' | 'health' | 'settings';
+    kind: 'action' | 'form' | 'status_card' | 'table' | 'link';
+    requiredCapability?: Capability;
+    inputSchema?: Record<string, unknown>;
+    executeActionId?: string;
+    readModelSelector?: string;
+}
+export type { RuntimeActionDefinition };
+export * from './plugin-runtime.js';
+export declare const KNOWN_PLUGIN_HOOKS: readonly ["onRuntimeStarted", "onTransportEvent", "onAction", "onRuntimeEvent", "beforeAgentPrompt", "afterAgentResponse", "onDomainEvent", "onRuntimeReceipt", "onRuntimeActivity"];
+export declare function validatePluginManifest(manifest: PluginManifest): PluginManifest;

package/dist/plugin.js

@@ -0,0 +1,77 @@
+import { validateJsonSchemaLike, validatePackageActivationRule, validatePackageDependencies, validatePackageId } from './package.js';
+import { isCapability, packageOwnsCapability } from './capabilities.js';
+export * from './plugin-runtime.js';
+export const KNOWN_PLUGIN_HOOKS = [
+    'onRuntimeStarted',
+    'onTransportEvent',
+    'onAction',
+    'onRuntimeEvent',
+    'beforeAgentPrompt',
+    'afterAgentResponse',
+    'onDomainEvent',
+    'onRuntimeReceipt',
+    'onRuntimeActivity'
+];
+const KNOWN_PLUGIN_HOOK_SET = new Set(KNOWN_PLUGIN_HOOKS);
+export function validatePluginManifest(manifest) {
+    if (!manifest || typeof manifest !== 'object' || Array.isArray(manifest)) {
+        throw new Error('Plugin manifest must be an object');
+    }
+    const record = manifest;
+    validatePackageId(record.id, 'Plugin manifest id');
+    if (typeof record.name !== 'string' || !record.name.trim()) {
+        throw new Error('Plugin manifest name is required');
+    }
+    if (typeof record.version !== 'string' || !record.version.trim()) {
+        throw new Error('Plugin manifest version is required');
+    }
+    if (record.type !== 'plugin') {
+        throw new Error('Plugin manifest type must be "plugin"');
+    }
+    if (record.description !== undefined && (typeof record.description !== 'string' || !record.description.trim())) {
+        throw new Error('Plugin manifest description must be non-empty when provided');
+    }
+    if (record.entrypoint !== undefined && (typeof record.entrypoint !== 'string' || !record.entrypoint.trim())) {
+        throw new Error('Plugin manifest entrypoint must be non-empty when provided');
+    }
+    if (record.priority !== undefined && (!Number.isInteger(record.priority) || record.priority < 0)) {
+        throw new Error('Plugin manifest priority must be a non-negative integer when provided');
+    }
+    if (record.defaultEnabled !== undefined && typeof record.defaultEnabled !== 'boolean') {
+        throw new Error('Plugin manifest defaultEnabled must be a boolean when provided');
+    }
+    if (record.displayCategory !== undefined &&
+        (typeof record.displayCategory !== 'string' || !record.displayCategory.trim())) {
+        throw new Error('Plugin manifest displayCategory must be a non-empty string when provided');
+    }
+    if (!Array.isArray(record.capabilities) || record.capabilities.length === 0) {
+        throw new Error('Plugin manifest capabilities must declare at least one capability');
+    }
+    validatePackageDependencies(record.dependencies, 'plugin manifest');
+    validateJsonSchemaLike(record.configSchema, 'plugin manifest');
+    const activation = validatePackageActivationRule(record.activation, 'plugin manifest');
+    for (const capability of record.capabilities) {
+        if (!isCapability(capability)) {
+            throw new Error(`Unknown capability: ${capability}`);
+        }
+        if (!packageOwnsCapability(record.id, capability)) {
+            throw new Error(`Package-local capability ${capability} is not owned by plugin ${record.id}`);
+        }
+    }
+    if (record.hooks !== undefined && !Array.isArray(record.hooks)) {
+        throw new Error('Plugin manifest hooks must be an array when provided');
+    }
+    for (const hook of record.hooks ?? []) {
+        if (typeof hook !== 'string' || !hook.trim()) {
+            throw new Error('Plugin manifest hooks must be non-empty');
+        }
+        if (!KNOWN_PLUGIN_HOOK_SET.has(hook)) {
+            throw new Error(`Unknown plugin hook: ${hook}`);
+        }
+    }
+    return {
+        ...manifest,
+        ...(activation !== undefined ? { activation } : {})
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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