aimeat 1.2.0

package/dist/src/services/federation.js

@@ -0,0 +1,201 @@
+/**
+ * Federation service — background heartbeat, GAII resolution cache,
+ * and peer health monitoring.
+ */
+import { createHash } from 'node:crypto';
+import { sign } from '../auth/keypair.js';
+import { computeCatalogueHash } from '../utils/catalogue-hash.js';
+import { logger } from '../utils/logger.js';
+/** Cache of resolved GAIIs to their hosting node URL. TTL: 5 minutes. */
+const gaiiCache = new Map();
+const CACHE_TTL_MS = 5 * 60_000;
+/** Consecutive failure counter per peer (for health tracking). */
+const peerFailures = new Map();
+/**
+ * Resolve which node hosts a GAII. Checks local cache first, then local storage,
+ * then falls back to asking peers.
+ */
+export async function resolveGaii(gaii, config, storage, peers) {
+    // 1. Cache check
+    const cached = gaiiCache.get(gaii);
+    if (cached && Date.now() < cached.expiresAt) {
+        return { nodeId: cached.nodeId, nodeUrl: cached.nodeUrl, local: cached.nodeId === config.nodeId };
+    }
+    // 2. Local check
+    const localAgent = await storage.getAgent(gaii);
+    if (localAgent) {
+        return { nodeId: config.nodeId, nodeUrl: config.baseUrl, local: true };
+    }
+    // 2b. Check personal nodes anchored to this operator
+    const personalNodes = await storage.listPersonalNodes();
+    for (const pn of personalNodes) {
+        if (pn.agentGaiis.includes(gaii)) {
+            gaiiCache.set(gaii, { nodeId: pn.nodeId, nodeUrl: config.baseUrl, expiresAt: Date.now() + CACHE_TTL_MS });
+            return { nodeId: pn.nodeId, nodeUrl: config.baseUrl, local: false };
+        }
+    }
+    // 3. Parse node hint from GAII (agent#owner@node)
+    const atIdx = gaii.lastIndexOf('@');
+    if (atIdx !== -1) {
+        const nodeHint = gaii.substring(atIdx + 1);
+        const peer = [...peers.values()].find(p => p.nodeId === nodeHint && p.status === 'active');
+        if (peer) {
+            gaiiCache.set(gaii, { nodeId: nodeHint, nodeUrl: peer.url, expiresAt: Date.now() + CACHE_TTL_MS });
+            return { nodeId: nodeHint, nodeUrl: peer.url, local: false };
+        }
+    }
+    // 4. Broadcast resolve to peers
+    const activePeers = [...peers.values()].filter(p => p.status === 'active');
+    for (const peer of activePeers) {
+        try {
+            const resp = await fetch(`${peer.url}/v1/agents/${encodeURIComponent(gaii)}`, {
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (resp.ok) {
+                gaiiCache.set(gaii, { nodeId: peer.nodeId, nodeUrl: peer.url, expiresAt: Date.now() + CACHE_TTL_MS });
+                return { nodeId: peer.nodeId, nodeUrl: peer.url, local: false };
+            }
+        }
+        catch {
+            // Continue to next peer
+        }
+    }
+    return null;
+}
+/** Cached catalogue hash per peer for change detection. */
+const peerCatalogueHashes = new Map();
+/** Start time for uptime reporting. */
+const startedAt = Date.now();
+/**
+ * Callback invoked when a peer recovers from unreachable/offline → active.
+ * Set by sync infrastructure (Phase B) when ready.
+ */
+let onPeerRecovery = null;
+/** Register a callback for peer recovery events (used by catalogue sync). */
+export function setOnPeerRecovery(cb) {
+    onPeerRecovery = cb;
+}
+/**
+ * Compute a per-peer stagger offset within the heartbeat interval.
+ * Uses SHA-256(localNodeId + peerNodeId) mod interval to distribute heartbeats.
+ */
+function peerStaggerMs(localNodeId, peerNodeId, intervalMs) {
+    const hash = createHash('sha256').update(localNodeId + peerNodeId).digest();
+    const offset = hash.readUInt32BE(0) % intervalMs;
+    return offset;
+}
+/**
+ * Start background heartbeat job. Pings all active peers with signed heartbeats
+ * containing catalogue hash and stats. Uses jittered scheduling (±25%) and
+ * per-peer stagger to prevent thundering herd.
+ */
+export function startHeartbeatJob(config, storage, peers) {
+    const BASE_INTERVAL_MS = 5 * 60_000;
+    const TIMEOUT_MS = config.federationTimeoutMs;
+    async function heartbeatCycle() {
+        // ── De-peering grace period enforcement ──
+        const depeeringPeers = [...peers.entries()].filter(([, p]) => p.status === 'depeering');
+        for (const [key, peer] of depeeringPeers) {
+            const graceEnd = peer.depeerGraceEnd;
+            if (graceEnd && new Date(graceEnd).getTime() <= Date.now()) {
+                peers.delete(key);
+                logger.info(`Peer ${peer.nodeId} purged after de-peering grace period expired`);
+            }
+        }
+        // ── Heartbeat active/degraded peers ──
+        const activePeers = [...peers.entries()].filter(([, p]) => p.status === 'active' || p.status === 'degraded');
+        if (activePeers.length === 0)
+            return;
+        // Compute stats once per cycle
+        const catalogueHash = await computeCatalogueHash(storage);
+        const nodeKey = await storage.getNodeKey();
+        const agents = await storage.listAgents();
+        const actions = await storage.listActions();
+        for (const [key, peer] of activePeers) {
+            // Per-peer stagger: skip this peer if not yet due
+            const stagger = peerStaggerMs(config.nodeId, peer.nodeId, BASE_INTERVAL_MS);
+            const cyclePhase = Date.now() % BASE_INTERVAL_MS;
+            if (Math.abs(cyclePhase - stagger) > BASE_INTERVAL_MS * 0.3)
+                continue;
+            try {
+                const payload = {
+                    node_id: config.nodeId,
+                    timestamp: new Date().toISOString(),
+                    version: 'v1',
+                    stats: {
+                        agents_active: agents.length,
+                        actions_published: actions.length,
+                        uptime_hours: (Date.now() - startedAt) / 3_600_000,
+                        catalogue_hash: catalogueHash,
+                    },
+                };
+                // Sign heartbeat payload with node Ed25519 key
+                const payloadJson = JSON.stringify(payload);
+                const signature = nodeKey
+                    ? await sign(nodeKey.privateKey, payloadJson)
+                    : undefined;
+                const resp = await fetch(`${peer.url}/v1/federation/ping`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ ...payload, signature }),
+                    signal: AbortSignal.timeout(TIMEOUT_MS),
+                });
+                if (resp.ok) {
+                    const previousStatus = peer.status;
+                    peer.lastSeen = new Date().toISOString();
+                    peer.status = 'active';
+                    peerFailures.set(key, 0);
+                    // Detect catalogue hash mismatch for sync triggering
+                    const cachedHash = peerCatalogueHashes.get(key);
+                    if (cachedHash && cachedHash !== catalogueHash) {
+                        logger.info(`Catalogue hash changed for peer ${peer.nodeId}, sync may be needed`);
+                    }
+                    peerCatalogueHashes.set(key, catalogueHash);
+                    // Recovery trigger: peer came back from unreachable/offline
+                    if ((previousStatus === 'offline' || previousStatus === 'unreachable') && onPeerRecovery) {
+                        logger.info(`Peer ${peer.nodeId} recovered from ${previousStatus}, triggering re-sync`);
+                        onPeerRecovery(key);
+                    }
+                }
+                else {
+                    const failures = (peerFailures.get(key) ?? 0) + 1;
+                    peerFailures.set(key, failures);
+                    if (failures >= 10) {
+                        peer.status = 'offline';
+                        logger.warn(`Peer ${peer.nodeId} offline after ${failures} consecutive failures`);
+                    }
+                    else if (failures >= 3) {
+                        peer.status = 'degraded';
+                        logger.warn(`Peer ${peer.nodeId} degraded after ${failures} consecutive failures`);
+                    }
+                }
+            }
+            catch {
+                const failures = (peerFailures.get(key) ?? 0) + 1;
+                peerFailures.set(key, failures);
+                if (failures >= 10) {
+                    peer.status = 'offline';
+                    logger.warn(`Peer ${peer.nodeId} offline after ${failures} consecutive failures`);
+                }
+                else if (failures >= 3) {
+                    peer.status = 'degraded';
+                }
+            }
+        }
+    }
+    // Jittered scheduling: ±25% random offset per cycle
+    function scheduleNext() {
+        const jitter = BASE_INTERVAL_MS * 0.25 * (Math.random() * 2 - 1);
+        const nextMs = Math.max(30_000, BASE_INTERVAL_MS + jitter);
+        setTimeout(() => {
+            heartbeatCycle().catch(err => {
+                logger.error('Heartbeat cycle failed', { error: err.message });
+            });
+            scheduleNext();
+        }, nextMs);
+    }
+    scheduleNext();
+    // Return an interval handle for compatibility (actual scheduling is via setTimeout chain)
+    return setInterval(() => { }, 2_147_483_647);
+}
+//# sourceMappingURL=federation.js.map

package/dist/src/services/federation.js.map

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

package/dist/src/services/foundry-debug.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @file foundry-debug.ts
+ * @description Debug artifact writer for the foundry pipeline — saves prompts,
+ *   generated code, test results, and logs to disk for easy debugging.
+ *   Files are written to data/debug/foundry/<projectId>/ in a structured
+ *   folder layout with one subfolder per component.
+ * @structure
+ *   - FoundryDebugWriter: per-project writer with methods for each artifact type
+ *   - getDebugBasePath(): returns the base debug directory path
+ *   - listDebugProjects(): lists all project IDs with debug data
+ *   - listDebugFiles(): lists files for a specific project
+ *   - readDebugFile(): reads a specific debug file
+ *   - deleteDebugProject(): removes all debug data for a project
+ * @usage
+ *   import { FoundryDebugWriter } from '../services/foundry-debug.js';
+ *   const debug = new FoundryDebugWriter(projectId);
+ *   await debug.writeComponentPrompt('ext-1', promptText);
+ * @version-history
+ *   v1.0.0 — 2026-03-26 — Copied from generator-debug.ts (v1.0.0) and renamed to foundry
+ */
+/** Get the base debug directory path */
+export declare function getDebugBasePath(): string;
+/**
+ * Per-project debug writer. Creates folder structure and writes artifacts.
+ * All writes are best-effort — failures are logged but don't throw.
+ */
+export declare class FoundryDebugWriter {
+    private projectId;
+    private projectPath;
+    private logPath;
+    constructor(projectId: string);
+    /** Ensure directory exists */
+    private ensureDir;
+    /** Write a file safely */
+    private safeWrite;
+    /** Write project metadata (project record, interview spec, blueprint) */
+    writeProjectMeta(project: Record<string, unknown>, interviewSpec: unknown, blueprint: unknown): Promise<void>;
+    /** Write the prompt sent to AI for component generation */
+    writeComponentPrompt(componentId: string, prompt: string): Promise<void>;
+    /** Write the AI-generated code */
+    writeComponentGenerated(componentId: string, code: string): Promise<void>;
+    /** Write validation result */
+    writeValidation(componentId: string, result: Record<string, unknown>): Promise<void>;
+    /** Write the test prompt sent to AI */
+    writeTestPrompt(componentId: string, prompt: string): Promise<void>;
+    /** Write AI-generated test code */
+    writeTestCode(componentId: string, code: string): Promise<void>;
+    /** Write test execution result */
+    writeTestResult(componentId: string, result: Record<string, unknown>): Promise<void>;
+    /** Write any named artifact — generic fallback for custom phases */
+    writeArtifact(componentId: string, name: string, content: string): Promise<void>;
+    /** Write fix round data */
+    writeFixRound(componentId: string, round: number, data: {
+        fixPrompt?: string;
+        fixResult?: string;
+        validation?: Record<string, unknown>;
+        testCode?: string;
+        testResult?: Record<string, unknown>;
+    }): Promise<void>;
+    /** Append a log entry (JSONL format — one JSON object per line) */
+    appendLog(entry: Record<string, unknown>): Promise<void>;
+    /** Write summary (overall result) */
+    writeSummary(summary: Record<string, unknown>): Promise<void>;
+}
+/** List all project IDs that have debug data */
+export declare function listDebugProjects(): Promise<Array<{
+    projectId: string;
+    createdAt: string;
+    fileCount: number;
+}>>;
+/** List all files for a specific project (relative paths) */
+export declare function listDebugFiles(projectId: string): Promise<string[]>;
+/** Read a specific debug file */
+export declare function readDebugFile(projectId: string, filePath: string): Promise<string | null>;
+/** Delete all debug data for a project */
+export declare function deleteDebugProject(projectId: string): Promise<boolean>;
+//# sourceMappingURL=foundry-debug.d.ts.map

package/dist/src/services/foundry-debug.d.ts.map

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

package/dist/src/services/foundry-debug.js

@@ -0,0 +1,214 @@
+/**
+ * @file foundry-debug.ts
+ * @description Debug artifact writer for the foundry pipeline — saves prompts,
+ *   generated code, test results, and logs to disk for easy debugging.
+ *   Files are written to data/debug/foundry/<projectId>/ in a structured
+ *   folder layout with one subfolder per component.
+ * @structure
+ *   - FoundryDebugWriter: per-project writer with methods for each artifact type
+ *   - getDebugBasePath(): returns the base debug directory path
+ *   - listDebugProjects(): lists all project IDs with debug data
+ *   - listDebugFiles(): lists files for a specific project
+ *   - readDebugFile(): reads a specific debug file
+ *   - deleteDebugProject(): removes all debug data for a project
+ * @usage
+ *   import { FoundryDebugWriter } from '../services/foundry-debug.js';
+ *   const debug = new FoundryDebugWriter(projectId);
+ *   await debug.writeComponentPrompt('ext-1', promptText);
+ * @version-history
+ *   v1.0.0 — 2026-03-26 — Copied from generator-debug.ts (v1.0.0) and renamed to foundry
+ */
+import { mkdir, writeFile, readdir, readFile, rm, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { existsSync } from 'node:fs';
+const DEBUG_BASE = join(process.cwd(), 'data', 'debug', 'foundry');
+/** Get the base debug directory path */
+export function getDebugBasePath() {
+    return DEBUG_BASE;
+}
+/**
+ * Per-project debug writer. Creates folder structure and writes artifacts.
+ * All writes are best-effort — failures are logged but don't throw.
+ */
+export class FoundryDebugWriter {
+    projectId;
+    projectPath;
+    logPath;
+    constructor(projectId) {
+        this.projectId = projectId;
+        this.projectPath = join(DEBUG_BASE, projectId);
+        this.logPath = join(this.projectPath, 'logs', 'full-log.jsonl');
+    }
+    /** Ensure directory exists */
+    async ensureDir(dir) {
+        await mkdir(dir, { recursive: true });
+    }
+    /** Write a file safely */
+    async safeWrite(filePath, content) {
+        try {
+            await this.ensureDir(join(filePath, '..'));
+            await writeFile(filePath, content, 'utf-8');
+        }
+        catch (e) {
+            console.error(`[foundry-debug] Failed to write ${filePath}:`, e.message);
+        }
+    }
+    /** Write project metadata (project record, interview spec, blueprint) */
+    async writeProjectMeta(project, interviewSpec, blueprint) {
+        await this.safeWrite(join(this.projectPath, 'project.json'), JSON.stringify(project, null, 2));
+        if (interviewSpec) {
+            await this.safeWrite(join(this.projectPath, 'interview-spec.json'), JSON.stringify(interviewSpec, null, 2));
+        }
+        if (blueprint) {
+            await this.safeWrite(join(this.projectPath, 'blueprint.json'), JSON.stringify(blueprint, null, 2));
+        }
+    }
+    /** Write the prompt sent to AI for component generation */
+    async writeComponentPrompt(componentId, prompt) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'prompt.txt'), prompt);
+    }
+    /** Write the AI-generated code */
+    async writeComponentGenerated(componentId, code) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'generated.txt'), code);
+    }
+    /** Write validation result */
+    async writeValidation(componentId, result) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'validation.json'), JSON.stringify(result, null, 2));
+    }
+    /** Write the test prompt sent to AI */
+    async writeTestPrompt(componentId, prompt) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'test-prompt.txt'), prompt);
+    }
+    /** Write AI-generated test code */
+    async writeTestCode(componentId, code) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'test-code.js'), code);
+    }
+    /** Write test execution result */
+    async writeTestResult(componentId, result) {
+        await this.safeWrite(join(this.projectPath, 'components', componentId, 'test-result.json'), JSON.stringify(result, null, 2));
+    }
+    /** Write any named artifact — generic fallback for custom phases */
+    async writeArtifact(componentId, name, content) {
+        // Sanitize name to prevent path traversal
+        const safeName = name.replace(/[^a-zA-Z0-9._-]/g, '_');
+        const ext = safeName.endsWith('.json') ? '' : '.txt';
+        await this.safeWrite(join(this.projectPath, 'components', componentId, safeName + ext), content);
+    }
+    /** Write fix round data */
+    async writeFixRound(componentId, round, data) {
+        const dir = join(this.projectPath, 'components', componentId, `fix-round-${round}`);
+        if (data.fixPrompt)
+            await this.safeWrite(join(dir, 'fix-prompt.txt'), data.fixPrompt);
+        if (data.fixResult)
+            await this.safeWrite(join(dir, 'fix-result.txt'), data.fixResult);
+        if (data.validation)
+            await this.safeWrite(join(dir, 'validation.json'), JSON.stringify(data.validation, null, 2));
+        if (data.testCode)
+            await this.safeWrite(join(dir, 'test-code.js'), data.testCode);
+        if (data.testResult)
+            await this.safeWrite(join(dir, 'test-result.json'), JSON.stringify(data.testResult, null, 2));
+    }
+    /** Append a log entry (JSONL format — one JSON object per line) */
+    async appendLog(entry) {
+        const line = JSON.stringify({ ...entry, timestamp: entry.timestamp || new Date().toISOString() }) + '\n';
+        try {
+            await this.ensureDir(join(this.projectPath, 'logs'));
+            const { appendFile } = await import('node:fs/promises');
+            await appendFile(this.logPath, line, 'utf-8');
+        }
+        catch (e) {
+            console.error(`[foundry-debug] Failed to append log:`, e.message);
+        }
+    }
+    /** Write summary (overall result) */
+    async writeSummary(summary) {
+        await this.safeWrite(join(this.projectPath, 'summary.json'), JSON.stringify(summary, null, 2));
+    }
+}
+/* ── Admin API helpers ─────────────────────────────────────────────── */
+/** List all project IDs that have debug data */
+export async function listDebugProjects() {
+    try {
+        if (!existsSync(DEBUG_BASE))
+            return [];
+        const entries = await readdir(DEBUG_BASE, { withFileTypes: true });
+        const projects = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const projectPath = join(DEBUG_BASE, entry.name);
+                let createdAt = '';
+                let fileCount = 0;
+                try {
+                    const s = await stat(join(projectPath, 'project.json'));
+                    createdAt = s.mtime.toISOString();
+                }
+                catch { /* */ }
+                try {
+                    fileCount = (await readdir(projectPath, { recursive: true })).length;
+                }
+                catch { /* */ }
+                projects.push({ projectId: entry.name, createdAt, fileCount });
+            }
+        }
+        return projects.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    catch {
+        return [];
+    }
+}
+/** List all files for a specific project (relative paths) */
+export async function listDebugFiles(projectId) {
+    const projectPath = join(DEBUG_BASE, projectId);
+    try {
+        if (!existsSync(projectPath))
+            return [];
+        const files = await readdir(projectPath, { recursive: true });
+        // Filter to files only (exclude directories) and normalize path separators
+        const result = [];
+        for (const f of files) {
+            const fullPath = join(projectPath, f);
+            try {
+                const s = await stat(fullPath);
+                if (s.isFile()) {
+                    result.push(f.split(sep).join('/'));
+                }
+            }
+            catch { /* */ }
+        }
+        return result.sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** Read a specific debug file */
+export async function readDebugFile(projectId, filePath) {
+    // Prevent path traversal
+    const normalizedPath = filePath.replace(/\.\./g, '').replace(/^\//, '');
+    const fullPath = join(DEBUG_BASE, projectId, normalizedPath);
+    const resolvedRelative = relative(DEBUG_BASE, fullPath);
+    if (resolvedRelative.startsWith('..') || resolvedRelative.includes('..'))
+        return null;
+    try {
+        return await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Delete all debug data for a project */
+export async function deleteDebugProject(projectId) {
+    const projectPath = join(DEBUG_BASE, projectId);
+    // Prevent path traversal
+    const resolvedRelative = relative(DEBUG_BASE, projectPath);
+    if (resolvedRelative.startsWith('..') || resolvedRelative.includes('..'))
+        return false;
+    try {
+        await rm(projectPath, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=foundry-debug.js.map

package/dist/src/services/foundry-debug.js.map

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

package/dist/src/services/foundry-registration.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file src/services/foundry-registration.ts
+ * @description Internal registration helpers used by the foundry pipeline.
+ * Extracted/adapted from src/routes/csm.ts, msm.ts, extensions.ts, apps.ts
+ * to allow agents to register components using owner GHII derived from their agent record.
+ * @structure
+ *   registerCsm(content, ownerName, storage)              — parse + validate + store CSM + schema
+ *   registerMsm(content, ownerName, storage)              — parse + validate + store MSM
+ *   registerExtension(content, ownerName, ownerGhii, storage, maxExtensionsPerOwner?) — parse YAML+JS + store ExtensionRecord
+ *   registerApp(content, ownerName, callerGaii, storage)  — store HTML as AppRecord
+ * @usage
+ *   import { registerCsm, registerMsm, registerExtension, registerApp } from '../services/foundry-registration.js';
+ * @version-history
+ *   v1.0.0 — 2026-03-26 — Copied from generator-registration.ts (v1.1.0) and renamed to foundry
+ */
+import type { Storage } from '../storage/interface.js';
+/**
+ * Register a CSM service definition on behalf of ownerName.
+ * Content is a YAML or JSON string. Mirrors POST /v1/csm logic exactly.
+ */
+export declare function registerCsm(content: string, ownerName: string, storage: Storage): Promise<void>;
+/**
+ * Register an MSM integration on behalf of ownerName.
+ * Content is a YAML or JSON string. Mirrors POST /v1/msm logic exactly.
+ */
+export declare function registerMsm(content: string, ownerName: string, storage: Storage): Promise<void>;
+/**
+ * Install an extension on behalf of ownerName.
+ * Content is the YAML+JS composite string produced by the foundry.
+ * The YAML block contains the manifest; JS fenced blocks contain action scripts.
+ * Mirrors POST /v1/extensions logic exactly.
+ * @param maxExtensionsPerOwner — optional per-owner limit; throws if exceeded
+ */
+export declare function registerExtension(content: string, ownerName: string, ownerGhii: string, storage: Storage, maxExtensionsPerOwner?: number): Promise<void>;
+/**
+ * Publish an app on behalf of ownerName / callerGaii.
+ * Content is base64-encoded HTML (or raw HTML). Mirrors POST /v1/apps logic.
+ * The foundry stores raw HTML; we accept both base64 and raw.
+ * @param callerGaii — storage identity used as ownerGaii (matches what apps.ts stores for agents)
+ */
+export declare function registerApp(content: string, ownerName: string, callerGaii: string, storage: Storage): Promise<void>;
+//# sourceMappingURL=foundry-registration.d.ts.map

package/dist/src/services/foundry-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry-registration.d.ts","sourceRoot":"","sources":["../../../src/services/foundry-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,yBAAyB,CAAC;AAIrF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DrG;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJ9J;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EzH"}