aimeat 1.2.0

package/dist/src/storage/interface.d.ts

@@ -0,0 +1,1161 @@
+export interface SemanticAnnotation {
+    '@context'?: Record<string, string>;
+    '@type'?: string;
+    [key: string]: unknown;
+}
+export interface OwnerRecord {
+    name: string;
+    displayName?: string;
+    publicKey: string;
+    roles: string[];
+    createdAt: string;
+}
+export interface AgentRecord {
+    name: string;
+    owner: string;
+    gaii: string;
+    displayName?: string;
+    description?: string;
+    capabilities: string[];
+    publicKey: string;
+    trustScore: number;
+    morselBalance: number;
+    createdAt: string;
+    lastSeen: string;
+    semantic?: SemanticAnnotation;
+    defaultScopes?: string[];
+    allowedOrigins?: string[];
+    dailySpendLimit?: number | null;
+}
+export interface MemoryRecord {
+    key: string;
+    ownerGaii: string;
+    value: unknown;
+    visibility: 'private' | 'owner' | 'public';
+    tags: string[];
+    ttlHours: number | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    flagCount?: number;
+    allowedOrigins?: string[];
+}
+export interface ActionRecord {
+    id: string;
+    providerGaii: string;
+    displayName: string;
+    description: string;
+    category?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    pricing: {
+        baseMorsels: number;
+        perUnit?: {
+            unit: string;
+            morselsPer1000: number;
+        };
+    };
+    estimatedTimeSeconds?: number;
+    maxInputSizeBytes?: number;
+    tags: string[];
+    webhookUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+    semantic?: SemanticAnnotation;
+}
+export interface WorkRecord {
+    trackingCode: string;
+    status: string;
+    actionId: string;
+    providerGaii: string;
+    requesterGaii: string;
+    input: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    cost: {
+        basePrice: number;
+        networkFee: number;
+        total: number;
+        inEscrow: number;
+    };
+    ttlExpiresAt: string;
+    callbackUrl?: string;
+    rating?: {
+        score: number;
+        comment?: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WalletTransaction {
+    id: string;
+    gaii: string;
+    type: string;
+    amount: number;
+    counterpartyGaii?: string;
+    trackingCode?: string;
+    timestamp: string;
+}
+export interface BoardRecord {
+    id: string;
+    name: string;
+    description?: string;
+    visibility: 'private' | 'shared' | 'public' | 'system';
+    ownerGaii: string;
+    allowedGaiis: string[];
+    createdAt: string;
+    semantic?: SemanticAnnotation;
+}
+export interface BoardPostRecord {
+    id: string;
+    boardId: string;
+    authorGaii: string;
+    title: string;
+    body: string;
+    category?: string;
+    tags: string[];
+    ttlExpiresAt?: string;
+    reactions: Record<string, string[]>;
+    replyTo?: string;
+    createdAt: string;
+    semantic?: SemanticAnnotation;
+}
+export interface OtkRecord {
+    key: string;
+    ownerGaii: string;
+    action: string;
+    params: Record<string, unknown>;
+    expiresAt: string;
+    initial: boolean;
+    used: boolean;
+    usedAt: string | null;
+    sessionId: string | null;
+    createdAt: string;
+}
+export interface OAuthClientRecord {
+    clientId: string;
+    clientSecret: string;
+    clientName: string;
+    redirectUris: string[];
+    createdAt: string;
+}
+export interface OAuthRefreshTokenRecord {
+    tokenHash: string;
+    clientId: string;
+    gaii: string;
+    owner: string;
+    roles: string[];
+    createdAt: string;
+}
+export interface OAuthApprovalRecord {
+    clientId: string;
+    gaii: string;
+    owner: string;
+    scope: string;
+    approvedAt: string;
+}
+export interface DeviceAuthorizationRecord {
+    deviceCode: string;
+    userCode: string;
+    ownerName: string;
+    agentName: string;
+    displayName?: string;
+    description?: string;
+    status: 'pending' | 'approved' | 'denied' | 'expired';
+    scopes?: string[];
+    createdAt: string;
+    expiresAt: string;
+    lastPolledAt?: string;
+    pollInterval: number;
+    approvedBy?: string;
+    agentCredentials?: {
+        gaii: string;
+        privateKey: string;
+        publicKey: string;
+        token?: string;
+        expires_at?: string;
+    };
+}
+export interface DisputeRecord {
+    id: string;
+    trackingCode: string;
+    status: 'open' | 'contested' | 'escalated' | 'resolved';
+    openedBy: string;
+    reason: string;
+    ruling?: {
+        ruling: string;
+        distribution: {
+            toRequester: number;
+            toProvider: number;
+            burned: number;
+        };
+        reason?: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DisputeAuditEntry {
+    sequence: number;
+    event: string;
+    actor: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+    hash: string;
+    previousHash: string;
+}
+export interface MicroMemoryRecord {
+    gaii: string;
+    set: string;
+    entries: Record<string, string>;
+    visibility: 'private' | 'public_read' | 'shared_read' | 'shared_write' | 'public_write';
+    accessCode?: string;
+    updatedAt: string;
+}
+export interface StorageFileRecord {
+    key: string;
+    ownerGaii: string;
+    visibility: 'private' | 'owner' | 'public';
+    mimeType: string;
+    size: number;
+    data: Buffer;
+    accessCode?: string;
+    tags?: string[];
+    createdAt: string;
+}
+export interface AppManifest {
+    name: string;
+    description: string;
+    version: string;
+    category: string;
+    tags: string[];
+    icon?: string;
+    authorDisplay: string;
+    usesCortex: string[];
+    priceMorsels?: number;
+    licenseType?: 'single' | 'lifetime';
+}
+export interface AppRecord {
+    ownerGaii: string;
+    ownerName: string;
+    filename: string;
+    versionNumber: number;
+    manifest: AppManifest;
+    mimeType: string;
+    size: number;
+    data: Buffer;
+    accessCode?: string;
+    createdAt: string;
+}
+export interface AppListOptions {
+    ownerGaii?: string;
+    category?: string;
+    q?: string;
+    tag?: string;
+    sort?: 'newest' | 'popular';
+    limit?: number;
+    offset?: number;
+    freeOnly?: boolean;
+}
+export interface AppPurchaseRecord {
+    transactionId: string;
+    buyerGaii: string;
+    buyerOwner: string;
+    sellerGaii: string;
+    sellerOwner: string;
+    appFilename: string;
+    appName: string;
+    appVersionNumber: number;
+    licenseType: 'single' | 'lifetime';
+    priceMorsels: number;
+    transactionFeeMorsels: number;
+    purchasedAt: string;
+    appContent: string;
+    appManifest: AppManifest;
+    appScreenshot?: string;
+    signature: string;
+    nodeId: string;
+    nodePublicKey: string;
+}
+export interface PeeringRequestRecord {
+    id: string;
+    fromNodeUrl: string;
+    fromNodeId?: string;
+    toNodeId?: string;
+    targetUrl?: string;
+    publicKey?: string;
+    message?: string;
+    status: 'pending' | 'approved' | 'rejected' | 'auto_approved';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChunkedUploadRecord {
+    uploadId: string;
+    ownerGaii: string;
+    key: string;
+    mimeType: string;
+    visibility: 'private' | 'owner' | 'public';
+    chunkSize: number;
+    totalChunks?: number;
+    receivedChunks: Map<number, Buffer>;
+    createdAt: string;
+    expiresAt: string;
+}
+export interface BoardSubscriptionRecord {
+    id: string;
+    boardId: string;
+    gaii: string;
+    callbackUrl?: string;
+    filters?: {
+        categories?: string[];
+        tags?: string[];
+    };
+    createdAt: string;
+}
+export interface GHIIRecord {
+    username: string;
+    nodeId: string;
+    ghii: string;
+    displayName: string;
+    bio?: string;
+    avatar?: string;
+    locale?: string;
+    passwordHash?: string;
+    verificationLevel: 0 | 1 | 2 | 3;
+    ownerName: string;
+    createdAt: string;
+    updatedAt: string;
+    totpSecret?: string;
+    totpEnabled: boolean;
+    totpBackupCodes?: string[];
+    totpLastUsedAt?: string;
+    totpLastUsedCode?: string;
+    totpFailedAttempts?: number;
+    totpLockedUntil?: string;
+    semantic?: SemanticAnnotation;
+    emailHash?: string;
+    emailVerifiedAt?: string;
+    verificationMethod?: 'email' | 'phone' | 'operator' | 'eidas';
+    magicLinkEnabled?: boolean;
+    notificationEmail?: string;
+    lastLoginAt?: string;
+    loginCount?: number;
+    verifiedAttributes?: string[];
+    verificationIssuer?: string;
+    verificationCredentialHash?: string;
+    ftnVerified?: boolean;
+    trustScore?: number;
+    morselBalance?: number;
+    allowedOrigins?: string[];
+}
+export interface ChatInstanceRecord {
+    id: string;
+    platform: string;
+    appName: string;
+    ownerName: string;
+    ghii: string;
+    nodeId: string;
+    isAnonymous: boolean;
+    createdAt: string;
+    lastSeen: string;
+    agentGaii?: string;
+    mcpClientId?: string;
+}
+export interface PersonalNodeRecord {
+    nodeId: string;
+    ownerName: string;
+    anchorNodeId: string;
+    publicKey: string;
+    status: 'online' | 'offline' | 'degraded' | 'detached';
+    agentGaiis: string[];
+    lastSeen: string;
+    mailboxQuotaBytes: number;
+    mailboxUsedBytes: number;
+    visibility: 'private' | 'public';
+    createdAt: string;
+    updatedAt: string;
+    semantic?: SemanticAnnotation;
+}
+export interface MailboxItemRecord {
+    id: string;
+    personalNodeId: string;
+    type: 'action_request' | 'work_assignment' | 'board_notification' | 'federation_sync';
+    fromGaii: string;
+    toGaii: string;
+    payload: string;
+    sizeBytes: number;
+    retentionDays: number;
+    expiresAt: string;
+    createdAt: string;
+}
+export interface PersonalPushSubscriptionRecord {
+    id: string;
+    personalNodeId: string;
+    ownerName: string;
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+    failureCount: number;
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+export interface NotificationPreferences {
+    personalNodeId: string;
+    enabled: boolean;
+    channels: ('web_push' | 'email')[];
+    notifyTypes: string[];
+    cooldownMinutes: number;
+    quietHoursUtc: {
+        start: string;
+        end: string;
+    } | null;
+    email: string | null;
+    locale?: string;
+}
+export interface MaintenanceState {
+    enabled: boolean;
+    message: string;
+    enabledAt: string | null;
+    enabledBy: string | null;
+}
+export interface ConsentRecord {
+    id: string;
+    ownerGaii: string;
+    dataPattern: string;
+    recipient: string;
+    purpose: string;
+    scope: 'private' | 'dmz' | 'federation';
+    expires: string | null;
+    status: 'active' | 'revoked' | 'expired';
+    grantedAt: string;
+    revokedAt: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ConsentAuditEntry {
+    id: string;
+    consentId: string;
+    ownerGaii: string;
+    accessorGaii: string;
+    memoryKey: string;
+    action: 'read' | 'list' | 'search';
+    timestamp: string;
+    allowed: boolean;
+}
+export interface CsmRecord {
+    name: string;
+    definition: Record<string, unknown>;
+    jsonSchemaKey: string;
+    serviceType: string;
+    registeredBy: string;
+    registeredAt: string;
+    updatedAt: string;
+    semantic?: SemanticAnnotation;
+    federate?: boolean;
+}
+export interface MsmRecord {
+    name: string;
+    definition: Record<string, unknown>;
+    category: string;
+    authType: string;
+    actionsCount: number;
+    registeredBy: string;
+    registeredAt: string;
+    updatedAt: string;
+    federate?: boolean;
+}
+export interface SemanticContext {
+    '@context'?: Record<string, string>;
+    '@type'?: string;
+    properties?: Record<string, unknown>;
+}
+export interface SchemaRecord {
+    keyPattern: string;
+    applyTo: 'exact' | 'prefix';
+    schemaJson: Record<string, unknown>;
+    schemaMode: 'open' | 'strict';
+    lockedBy: string;
+    setAt: string;
+    updatedAt: string;
+    semanticContext?: SemanticContext;
+}
+export interface EmailVerificationRecord {
+    id: string;
+    ownerName: string;
+    emailHash: string;
+    code: string;
+    purpose: 'registration' | 'login' | 'change' | 'password_reset' | 'account_recovery' | 'email_verification';
+    status: 'pending' | 'verified' | 'expired';
+    attempts: number;
+    expiresAt: string;
+    createdAt: string;
+    verifiedAt: string | null;
+}
+export interface FlagRecord {
+    id: string;
+    targetType: 'memory' | 'board_post' | 'action' | 'agent';
+    targetId: string;
+    flaggedBy: string;
+    reason: 'unreliable' | 'inappropriate' | 'illegal' | 'spam' | 'other';
+    description?: string;
+    status: 'active' | 'dismissed' | 'actioned';
+    reviewedBy?: string;
+    reviewedAt?: string;
+    createdAt: string;
+}
+export interface FlagSummary {
+    targetType: string;
+    targetId: string;
+    totalFlags: number;
+    byReason: Record<string, number>;
+    latestFlag: string;
+    hidden?: boolean;
+}
+export interface MatchRecord {
+    id: string;
+    profileA: string;
+    profileB: string;
+    score: number;
+    breakdown: {
+        sharedInterests: string[];
+        distanceKm: number | null;
+        activityDays: number;
+        sharedInterestsScore: number;
+        distanceScore: number;
+        activityScore: number;
+        compatibilityScore: number;
+    };
+    status: 'suggested' | 'notified' | 'accepted' | 'dismissed' | 'expired';
+    notifiedAt: string | null;
+    respondedAt: string | null;
+    expiresAt: string;
+    createdAt: string;
+}
+export interface OrganismRecord {
+    id: string;
+    name: string;
+    description: string;
+    type: 'community' | 'team' | 'club' | 'cooperative' | 'project';
+    location?: {
+        city?: string;
+        area?: string;
+        country?: string;
+        geo?: [number, number];
+    };
+    interests: string[];
+    creatorGhii: string;
+    admins: string[];
+    members: string[];
+    agentGaiis: string[];
+    boardId: string;
+    joinPolicy: 'open' | 'approval_required' | 'invite_only';
+    maxMembers: number;
+    visibility: 'public' | 'listed' | 'private';
+    moderationConfig: {
+        flagsEnabled: boolean;
+        autoHideThreshold: number;
+        appealsEnabled: boolean;
+    };
+    memoryNamespace: string;
+    semantic?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface OrganismMembershipRecord {
+    id: string;
+    organismId: string;
+    ghii: string;
+    role: 'creator' | 'admin' | 'member';
+    status: 'active' | 'pending' | 'banned';
+    joinedAt: string;
+    invitedBy?: string;
+}
+export interface JoinRequestRecord {
+    id: string;
+    organismId: string;
+    ghii: string;
+    message?: string;
+    status: 'pending' | 'approved' | 'rejected';
+    reviewedBy?: string;
+    createdAt: string;
+    reviewedAt?: string;
+}
+/** @deprecated Use marketplace-behaviors extension instead */
+export interface ListingRecord {
+    id: string;
+    ownerName: string;
+    sellerGhii: string;
+    title: string;
+    description: string;
+    category: 'palvelut' | 'tuotteet' | 'data' | 'osaaminen' | 'muu';
+    priceMorsels: number;
+    condition?: 'new' | 'used' | 'digital';
+    availability?: 'immediate' | 'on_request' | 'scheduled';
+    location?: {
+        city?: string;
+        area?: string;
+    };
+    tags?: string[];
+    images?: string[];
+    status: 'active' | 'sold' | 'expired' | 'hidden' | 'delisted';
+    memoryKey: string;
+    flagCount: number;
+    createdAt: string;
+    updatedAt: string;
+    semantic?: Record<string, unknown>;
+}
+/** @deprecated Use marketplace-behaviors extension instead */
+export interface PurchaseRecord {
+    id: string;
+    listingId: string;
+    buyerOwner: string;
+    sellerOwner: string;
+    priceMorsels: number;
+    transactionFeeMorsels: number;
+    totalCostMorsels: number;
+    status: 'pending_delivery' | 'delivered' | 'disputed' | 'completed' | 'cancelled';
+    rating?: {
+        score: number;
+        comment?: string;
+    };
+    trackingCode: string;
+    createdAt: string;
+    completedAt?: string;
+}
+export interface AppealRecord {
+    id: string;
+    flagId: string;
+    appealedBy: string;
+    reason: string;
+    status: 'pending' | 'upheld' | 'overturned';
+    reviewedBy?: string;
+    reviewNote?: string;
+    createdAt: string;
+    reviewedAt?: string;
+}
+export interface PushSubscriptionRecord {
+    ownerName: string;
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+    createdAt: string;
+    lastUsedAt: string;
+}
+export interface NotificationTemplateRecord {
+    id: string;
+    locale: string;
+    fields: {
+        title?: string;
+        body: string;
+        subject?: string;
+    };
+    placeholders: string[];
+    updatedAt: string;
+    updatedBy: string;
+}
+export interface TrustedIssuerRecord {
+    id: string;
+    name: string;
+    url: string;
+    publicKey: string;
+    type: 'eudiw' | 'ftn' | 'w3c_vc' | 'custom';
+    trusted: boolean;
+    addedBy: string;
+    createdAt: string;
+}
+export interface GenesisPeerRecord {
+    id: string;
+    genesisNodeId: string;
+    genesisUrl: string;
+    publicKey: string;
+    status: 'pending' | 'active' | 'suspended';
+    lastSyncAt: string;
+    catalogueHash: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReplicationQueueEntry {
+    id: string;
+    type: 'catalogue_sync' | 'memory_replicate' | 'trust_advisory';
+    targetPeers: string[];
+    payload: unknown;
+    createdAt: string;
+    attempts: number;
+    lastAttemptAt: string | null;
+    status: 'pending' | 'sent' | 'failed';
+}
+export interface OrganismReputationRecord {
+    organismId: string;
+    score: number;
+    breakdown: {
+        memberScore: number;
+        activityScore: number;
+        trustScore: number;
+        ageScore: number;
+        flagScore: number;
+    };
+    calculatedAt: string;
+}
+export interface RealtimeRoomRecord {
+    id: string;
+    appType: string;
+    name: string;
+    createdBy: string;
+    maxPeers: number;
+    isPublic: boolean;
+    tags: string[];
+    peerCount: number;
+    createdAt: string;
+    lastActivityAt: string;
+}
+export interface SiteChangeLogEntry {
+    id: string;
+    action: 'template_upload' | 'template_delete' | 'import' | 'cache_invalidate' | 'app_publish' | 'app_update' | 'app_delete';
+    summary: string;
+    changedBy: string;
+    changedAt: string;
+}
+export interface ExtensionRecord {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    status: 'inactive' | 'active';
+    requiredApis: string[];
+    actions: Array<{
+        id: string;
+        method: string;
+        path: string;
+        inputSchema: Record<string, unknown>;
+        outputSchema: Record<string, unknown>;
+        scriptContent: string;
+    }>;
+    config: Record<string, unknown>;
+    limits: {
+        memoryMb: number;
+        timeoutMs: number;
+        maxApiCalls: number;
+    };
+    federation: {
+        advertise: boolean;
+        capabilities: string[];
+    };
+    instances?: {
+        supported: boolean;
+        configSchema?: Record<string, unknown>;
+    };
+    installedBy: string;
+    installedAt: string;
+    activatedAt?: string;
+}
+export interface ScheduledJobRecord {
+    id: string;
+    name: string;
+    type: 'extension' | 'core';
+    extensionName?: string;
+    instanceId?: string;
+    actionId?: string;
+    coreHandler?: string;
+    cron: string;
+    enabled: boolean;
+    input?: Record<string, unknown>;
+    lastRunAt?: string;
+    lastRunResult?: 'success' | 'error';
+    lastRunError?: string;
+    lastRunDurationMs?: number;
+    nextRunAt?: string;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ExecutionLogEntry {
+    id: string;
+    jobId: string;
+    jobName: string;
+    type: 'extension' | 'core';
+    extensionName?: string;
+    actionId?: string;
+    trigger: 'cron' | 'manual' | 'activate';
+    result: 'success' | 'error' | 'skipped';
+    errorMessage?: string;
+    durationMs: number;
+    memoryReads: string[];
+    memoryWrites: string[];
+    createdAt: string;
+}
+export interface ExtensionInstanceRecord {
+    id: string;
+    extensionName: string;
+    config: Record<string, unknown>;
+    status: 'active' | 'paused';
+    /** Per-locale translation overrides: { "en": { "mkt.cat.foo": "Foo" }, "fi": { ... } } */
+    translations?: Record<string, Record<string, string>>;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EscrowHoldRecord {
+    holdId: string;
+    fromGaii: string;
+    amount: number;
+    reason: string;
+    status: 'held' | 'released' | 'disputed' | 'refunded';
+    extensionName: string;
+    createdAt: string;
+    releasedAt?: string;
+    releasedTo?: string;
+}
+export interface CortexSchemaComponent {
+    type: 'schema';
+    name: string;
+    key_pattern: string;
+    apply_to: 'prefix' | 'exact';
+    schema: Record<string, unknown>;
+}
+export interface CortexPromptComponent {
+    type: 'prompt';
+    name: string;
+    content: string;
+    variables?: string[];
+}
+export interface CortexActionComponent {
+    type: 'action';
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export interface CortexBoardTemplateComponent {
+    type: 'board-template';
+    name: string;
+    title: string;
+    description: string;
+    visibility: 'public' | 'private' | 'shared';
+    seed_posts?: Array<{
+        title: string;
+        body: string;
+    }>;
+}
+export interface CortexOntologyComponent {
+    type: 'ontology';
+    name: string;
+    description: string;
+    concepts: Record<string, {
+        label: Record<string, string>;
+        properties?: string[];
+        broader?: string;
+        related_to?: string;
+        values?: string[];
+    }>;
+}
+export interface CortexSeedDataComponent {
+    type: 'seed-data';
+    entries: Array<{
+        key: string;
+        value: unknown;
+    }>;
+}
+export interface CortexLibComponent {
+    type: 'lib';
+    name: string;
+    filename: string;
+    exports: string[];
+    api_surface: string;
+}
+export type CortexComponent = CortexSchemaComponent | CortexPromptComponent | CortexActionComponent | CortexBoardTemplateComponent | CortexOntologyComponent | CortexSeedDataComponent | CortexLibComponent;
+export interface CortexActivationArtifacts {
+    schemaKeys: string[];
+    promptKeys: string[];
+    actionIds: string[];
+    boardIds: string[];
+    seedDataKeys: string[];
+    ontologyKeys: string[];
+    libFiles: string[];
+}
+export interface CortexExtensionRecord {
+    name: string;
+    namespace: string;
+    shortName: string;
+    apiVersion: string;
+    version: string;
+    description: string;
+    author: string;
+    license?: string;
+    tags: string[];
+    labels: Record<string, string>;
+    aimeatCompat?: string;
+    status: 'inactive' | 'active';
+    visibility: 'private' | 'public';
+    installedAt: string;
+    activatedAt?: string;
+    installedBy: string;
+    manifest: string;
+    components: CortexComponent[];
+    activationArtifacts: CortexActivationArtifacts;
+}
+export type KnowledgeContentType = 'idea' | 'research' | 'plan' | 'dataset' | 'document' | 'tutorial' | 'collection' | 'article' | 'story' | 'fiction';
+export type KnowledgeSynthesisLevel = 'original' | 'assisted' | 'synthesized' | 'ai-generated';
+export type KnowledgeMaturity = 'draft' | 'review' | 'published';
+export type KnowledgeLinkRelation = 'related-to' | 'extends' | 'derived-from' | 'contradicts' | 'supersedes' | 'references';
+export interface KnowledgeReference {
+    url: string;
+    title: string;
+    accessed: string;
+    verified: boolean;
+    note?: string;
+}
+export interface KnowledgeEntryRelation {
+    key: string;
+    relation: KnowledgeLinkRelation;
+}
+export interface KnowledgeEntryDescriptor {
+    key: string;
+    title: string;
+    visibility: 'private' | 'owner' | 'public';
+    schema?: string;
+    references?: KnowledgeReference[];
+    related_entries?: KnowledgeEntryRelation[];
+}
+export interface KnowledgeLink {
+    target: string;
+    relation: KnowledgeLinkRelation;
+    description: string;
+    linked_at: string;
+}
+export interface KnowledgeSynthesis {
+    level: KnowledgeSynthesisLevel;
+    description: string;
+    model?: string;
+}
+export interface KnowledgeSharing {
+    catalog_listed: boolean;
+    allow_clone: boolean;
+    license?: string;
+    morsel_price: number;
+}
+export interface KnowledgeManifest {
+    type: 'knowledge-package';
+    name: string;
+    version: string;
+    author: string;
+    created: string;
+    updated: string;
+    content_type: KnowledgeContentType;
+    tags: string[];
+    language: string;
+    maturity: KnowledgeMaturity;
+    synthesis: KnowledgeSynthesis;
+    references: KnowledgeReference[];
+    entries: KnowledgeEntryDescriptor[];
+    links: KnowledgeLink[];
+    sharing: KnowledgeSharing;
+}
+export interface MemoryLinkRecord {
+    source: string;
+    target: string;
+    relation: KnowledgeLinkRelation;
+    description: string;
+    linked_at: string;
+    linked_by: string;
+}
+export type OperatorReviewReason = 'routine_review' | 'legal_compliance' | 'community_report' | 'content_quality' | 'storage_issue' | 'custom';
+export type OperatorReviewAction = 'approve' | 'flag' | 'delist' | 'restrict' | 'note';
+export interface OperatorReviewRecord {
+    id: string;
+    packageId: string;
+    operatorGaii: string;
+    reason: OperatorReviewReason;
+    customText?: string;
+    action: OperatorReviewAction;
+    timestamp: string;
+}
+export interface SystemPromptRecord {
+    id: string;
+    group: string;
+    name: string;
+    description: string;
+    content: string;
+    locales?: Record<string, string>;
+    active: boolean;
+    variables: string[];
+    usedIn: string[];
+    version: number;
+    updatedAt: string;
+    updatedBy: string;
+}
+export interface SystemPromptVersionRecord {
+    promptId: string;
+    version: number;
+    content: string;
+    locales?: Record<string, string>;
+    changedBy: string;
+    changedAt: string;
+    changeNote?: string;
+}
+/** Shared type alias for all AIMEAT component types that can be included in a package. */
+export type PackageComponentType = 'csm' | 'extension' | 'cortex' | 'app' | 'msm' | 'memory' | 'translation';
+/** A single component within a package version. */
+export interface PackageComponent {
+    id: string;
+    type: PackageComponentType;
+    label: string;
+    content: string;
+    contentHash: string;
+    dependencies: string[];
+}
+/**
+ * One record per package version. All versions of the same package share a packageGroupId.
+ * Version format: v{YYYY}-{MM}-{DD}-{HHmm} — e.g. v2026-03-15-1701
+ */
+export interface PackageRecord {
+    id: string;
+    packageGroupId: string;
+    name: string;
+    author: string;
+    authorGhii: string;
+    version: string;
+    changelog: string;
+    description: string;
+    category: string;
+    tags: string[];
+    visibility: 'private' | 'public';
+    status: 'draft' | 'published' | 'archived';
+    components: PackageComponent[];
+    manifest: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PackageFilter {
+    author?: string;
+    category?: string;
+    status?: string;
+    visibility?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Social/discovery layer. One record per package group (not per version). */
+export interface TemplateListingRecord {
+    id: string;
+    packageGroupId: string;
+    packageName: string;
+    packageAuthor: string;
+    publishedBy: string;
+    publishedByGhii: string;
+    title: string;
+    description: string;
+    screenshots: string[];
+    category: string;
+    tags: string[];
+    featured: boolean;
+    installCount: number;
+    rating: number;
+    reviewCount: number;
+    status: 'listed' | 'unlisted' | 'moderated' | 'pending_review' | 'rejected' | 'suspended';
+    createdAt: string;
+    updatedAt: string;
+    rejectionReason?: string;
+    reviewedBy?: string;
+    reviewedAt?: string;
+    reviewComment?: string;
+    proposedAt?: string;
+    proposedBy?: string;
+}
+export interface TemplateReview {
+    id: string;
+    listingId: string;
+    authorGhii: string;
+    authorName: string;
+    rating: number;
+    comment: string;
+    createdAt: string;
+}
+export interface TemplateDiscussion {
+    id: string;
+    listingId: string;
+    authorGhii: string;
+    authorName: string;
+    message: string;
+    parentId?: string;
+    createdAt: string;
+}
+export interface TemplateFilter {
+    category?: string;
+    tags?: string[];
+    featured?: boolean;
+    status?: string;
+    sort?: 'rating' | 'installs' | 'newest';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Tracks an installed copy of a package. */
+export interface PackageInstanceRecord {
+    id: string;
+    packageGroupId: string;
+    packageVersion: string;
+    packageRecordId: string;
+    owner: string;
+    ownerGhii: string;
+    label: string;
+    installedComponents: InstalledComponent[];
+    status: 'active' | 'paused' | 'removed';
+    installedAt: string;
+    updatedAt: string;
+}
+export interface InstalledComponent {
+    componentId: string;
+    type: PackageComponentType;
+    registeredAs: string;
+    originalHash: string;
+    customized: boolean;
+    customizedAt?: string;
+}
+export interface InstanceFilter {
+    owner?: string;
+    ownerGhii?: string;
+    packageGroupId?: string;
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+import type { OwnerRepository } from './repositories/owner.repository.js';
+import type { AgentRepository } from './repositories/agent.repository.js';
+import type { MemoryRepository } from './repositories/memory.repository.js';
+import type { ActionRepository } from './repositories/action.repository.js';
+import type { WorkRepository } from './repositories/work.repository.js';
+import type { WalletRepository } from './repositories/wallet.repository.js';
+import type { BoardRepository } from './repositories/board.repository.js';
+import type { OtkRepository } from './repositories/otk.repository.js';
+import type { DisputeRepository } from './repositories/dispute.repository.js';
+import type { MicroMemoryRepository } from './repositories/micro-memory.repository.js';
+import type { FileRepository } from './repositories/file.repository.js';
+import type { IdentityRepository } from './repositories/identity.repository.js';
+import type { SchemaRepository } from './repositories/schema.repository.js';
+import type { ConsentRepository } from './repositories/consent.repository.js';
+import type { CatalogueRepository } from './repositories/catalogue.repository.js';
+import type { ModerationRepository } from './repositories/moderation.repository.js';
+import type { OrganismRepository } from './repositories/organism.repository.js';
+import type { MarketplaceRepository } from './repositories/marketplace.repository.js';
+import type { FederationRepository } from './repositories/federation.repository.js';
+import type { NodeRepository } from './repositories/node.repository.js';
+import type { NotificationRepository } from './repositories/notification.repository.js';
+import type { AuthRepository } from './repositories/auth.repository.js';
+import type { SessionRepository } from './repositories/session.repository.js';
+import type { AppRepository } from './repositories/app.repository.js';
+import type { AppMarketplaceRepository } from './repositories/app-marketplace.repository.js';
+import type { ConfigRepository } from './repositories/config.repository.js';
+import type { NotificationTemplateRepository } from './repositories/notification-template.repository.js';
+import type { KnowledgeRepository } from './repositories/knowledge.repository.js';
+import type { SchedulerRepository } from './repositories/scheduler.repository.js';
+import type { ExtensionInstanceRepository } from './repositories/extension-instance.repository.js';
+import type { ReplicationQueueRepository } from './repositories/replication-queue.repository.js';
+import type { DeviceAuthRepository } from './repositories/device-auth.repository.js';
+import type { OAuthRepository } from './repositories/oauth.repository.js';
+import type { SystemPromptRepository } from './repositories/system-prompt.repository.js';
+import type { PackageRepository } from './repositories/package.repository.js';
+import type { TemplateListingRepository } from './repositories/template-listing.repository.js';
+import type { PackageInstanceRepository } from './repositories/package-instance.repository.js';
+export interface Storage extends OwnerRepository, AgentRepository, MemoryRepository, ActionRepository, WorkRepository, WalletRepository, BoardRepository, OtkRepository, DisputeRepository, MicroMemoryRepository, FileRepository, IdentityRepository, SchemaRepository, ConsentRepository, CatalogueRepository, ModerationRepository, OrganismRepository, MarketplaceRepository, FederationRepository, NodeRepository, NotificationRepository, AuthRepository, SessionRepository, AppRepository, AppMarketplaceRepository, ConfigRepository, NotificationTemplateRepository, KnowledgeRepository, SchedulerRepository, ExtensionInstanceRepository, ReplicationQueueRepository, DeviceAuthRepository, OAuthRepository, SystemPromptRepository, PackageRepository, TemplateListingRepository, PackageInstanceRepository {
+}
+//# sourceMappingURL=interface.d.ts.map