@opendatalabs/connect 0.8.1-canary.ff55fb0 → 0.9.0

package/dist/core/state-store.js

@@ -1,6 +1,11 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { getCliStatePath, getDataConnectHome } from "./paths.js";
+import crypto from "node:crypto";
+import { getCliStatePath, getVanaHome } from "./paths.js";
+const STATE_LOCK_TIMEOUT_MS = 5_000;
+const STATE_LOCK_RETRY_MS = 25;
+const STATE_LOCK_STALE_MS = 30_000;
+let testHooks;
 export async function readCliState() {
     try {
         const raw = await fs.readFile(getCliStatePath(), "utf8");
@@ -11,13 +16,86 @@ export async function readCliState() {
     }
 }
 export async function updateSourceState(source, patch) {
+    await fs.mkdir(getVanaHome(), { recursive: true });
+    await withStateFileLock(async () => {
+        await testHooks?.beforeRead?.();
+        const state = await readCliState();
+        const current = state.sources[source] ?? {};
+        state.sources[source] = { ...current, ...patch };
+        await testHooks?.beforeWrite?.();
+        await atomicWriteFile(getCliStatePath(), `${JSON.stringify(state, null, 2)}\n`);
+    });
+}
+export async function readCliConfig() {
     const state = await readCliState();
-    const current = state.sources[source] ?? {};
-    state.sources[source] = { ...current, ...patch };
-    await fs.mkdir(getDataConnectHome(), { recursive: true });
-    await fs.writeFile(getCliStatePath(), `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    return state.config ?? {};
+}
+export async function updateCliConfig(patch) {
+    await fs.mkdir(getVanaHome(), { recursive: true });
+    await withStateFileLock(async () => {
+        await testHooks?.beforeRead?.();
+        const state = await readCliState();
+        state.config = { ...(state.config ?? {}), ...patch };
+        await testHooks?.beforeWrite?.();
+        await atomicWriteFile(getCliStatePath(), `${JSON.stringify(state, null, 2)}\n`);
+    });
 }
 export async function ensureParentDir(filePath) {
     await fs.mkdir(path.dirname(filePath), { recursive: true });
 }
+export function __setStateStoreTestHooks(hooks) {
+    testHooks = hooks;
+}
+async function withStateFileLock(fn) {
+    const lockPath = `${getCliStatePath()}.lock`;
+    const start = Date.now();
+    while (true) {
+        try {
+            const handle = await fs.open(lockPath, "wx");
+            try {
+                return await fn();
+            }
+            finally {
+                await handle.close();
+                await fs.rm(lockPath, { force: true });
+            }
+        }
+        catch (error) {
+            if (!isLockAlreadyHeld(error)) {
+                throw error;
+            }
+            if (await isStaleLock(lockPath)) {
+                await fs.rm(lockPath, { force: true });
+                continue;
+            }
+            if (Date.now() - start >= STATE_LOCK_TIMEOUT_MS) {
+                throw new Error("Timed out waiting for the Vana Connect state file lock.");
+            }
+            await sleep(STATE_LOCK_RETRY_MS);
+        }
+    }
+}
+async function atomicWriteFile(filePath, contents) {
+    const tempPath = `${filePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await fs.writeFile(tempPath, contents, "utf8");
+    await fs.rename(tempPath, filePath);
+}
+async function isStaleLock(lockPath) {
+    try {
+        const stats = await fs.stat(lockPath);
+        return Date.now() - stats.mtimeMs > STATE_LOCK_STALE_MS;
+    }
+    catch {
+        return false;
+    }
+}
+function isLockAlreadyHeld(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 //# sourceMappingURL=state-store.js.map

package/dist/core/state-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/core/state-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBjE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,KAAwB;IAExB,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IAEjD,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,SAAS,CAChB,eAAe,EAAE,EACjB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACrC,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/core/state-store.ts"],"names":[],"mappings":"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"}

package/dist/personal-server/client.d.ts

@@ -0,0 +1,34 @@
+import type { PersonalServerHealth } from "./index.js";
+export interface IngestScopeResult {
+    scope: string;
+    status: "stored" | "failed";
+    collectedAt?: string;
+    error?: string;
+}
+export interface ScopeSummary {
+    scope: string;
+    count: number;
+}
+export interface PersonalServerClient {
+    health(): Promise<PersonalServerHealth>;
+    ingestScope(scope: string, data: unknown): Promise<IngestScopeResult>;
+    listScopes(prefix?: string): Promise<ScopeSummary[]>;
+}
+/**
+ * Create an HTTP client for a Vana personal server.
+ *
+ * @param config - Connection configuration
+ * @param config.url - Base URL of the personal server
+ * @param config.auth - Optional authentication configuration
+ * @returns A PersonalServerClient instance
+ */
+export declare function createPersonalServerClient(config: {
+    url: string;
+    auth?: {
+        type: "devToken";
+        token: string;
+    } | {
+        type: "none";
+    };
+}): PersonalServerClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/personal-server/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/personal-server/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,GAAG,oBAAoB,CAoGvB"}

package/dist/personal-server/client.js

@@ -0,0 +1,94 @@
+/**
+ * Create an HTTP client for a Vana personal server.
+ *
+ * @param config - Connection configuration
+ * @param config.url - Base URL of the personal server
+ * @param config.auth - Optional authentication configuration
+ * @returns A PersonalServerClient instance
+ */
+export function createPersonalServerClient(config) {
+    const baseUrl = config.url.replace(/\/+$/, "");
+    function authHeaders() {
+        if (config.auth?.type === "devToken") {
+            return { Authorization: `Bearer ${config.auth.token}` };
+        }
+        return {};
+    }
+    return {
+        async health() {
+            const response = await fetch(`${baseUrl}/health`, {
+                method: "GET",
+                signal: AbortSignal.timeout(2_000),
+            });
+            if (!response.ok) {
+                throw new Error(`Health check failed: ${response.status}`);
+            }
+            const body = (await response.json());
+            return {
+                status: typeof body.status === "string" ? body.status : "unknown",
+                version: typeof body.version === "string" ? body.version : "unknown",
+                uptime: typeof body.uptime === "number" ? body.uptime : 0,
+                owner: typeof body.owner === "string" ? body.owner : null,
+            };
+        },
+        async ingestScope(scope, data) {
+            try {
+                const response = await fetch(`${baseUrl}/v1/data/${scope}`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        ...authHeaders(),
+                    },
+                    body: JSON.stringify(data),
+                });
+                if (response.status === 201 || (response.ok && response.status < 300)) {
+                    const body = (await response.json().catch(() => ({})));
+                    return {
+                        scope,
+                        status: "stored",
+                        collectedAt: typeof body.collectedAt === "string"
+                            ? body.collectedAt
+                            : new Date().toISOString(),
+                    };
+                }
+                const errorText = await response.text().catch(() => "Unknown error");
+                return {
+                    scope,
+                    status: "failed",
+                    error: `HTTP ${response.status}: ${errorText}`,
+                };
+            }
+            catch (error) {
+                return {
+                    scope,
+                    status: "failed",
+                    error: error instanceof Error ? error.message : "Unknown error",
+                };
+            }
+        },
+        async listScopes(prefix) {
+            // This endpoint requires auth — if no auth configured, return empty.
+            if (!config.auth || config.auth.type === "none") {
+                return [];
+            }
+            try {
+                const params = prefix
+                    ? `?scopePrefix=${encodeURIComponent(prefix)}`
+                    : "";
+                const response = await fetch(`${baseUrl}/v1/data${params}`, {
+                    method: "GET",
+                    headers: authHeaders(),
+                });
+                if (!response.ok) {
+                    return [];
+                }
+                const body = (await response.json());
+                return body.scopes ?? [];
+            }
+            catch {
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/personal-server/client.js.map

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

package/dist/personal-server/index.d.ts

@@ -1,7 +1,17 @@
 import type { CliEvent, PersonalServerState } from "../core/cli-types.js";
+export { createPersonalServerClient } from "./client.js";
+export type { PersonalServerClient, IngestScopeResult, ScopeSummary, } from "./client.js";
+export interface PersonalServerHealth {
+    status: string;
+    version: string;
+    uptime: number;
+    owner: string | null;
+}
 export interface PersonalServerTarget {
     state: PersonalServerState;
     url: string | null;
+    source: "config" | "env" | "scan" | null;
+    health: PersonalServerHealth | null;
 }
 export declare function detectPersonalServerTarget(): Promise<PersonalServerTarget>;
 export declare function ingestResult(source: string, resultPath: string, target: PersonalServerTarget): Promise<CliEvent[]>;

package/dist/personal-server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/personal-server/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI1E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAgBhF;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsDrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/personal-server/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAO1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACrC;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAmChF;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoErB"}

package/dist/personal-server/index.js

@@ -1,19 +1,43 @@
 import fs from "node:fs/promises";
+import { readCliConfig } from "../core/state-store.js";
+import { resolveScopes } from "./scope-resolver.js";
+import { createPersonalServerClient } from "./client.js";
+import { readCachedConnectorMetadata } from "../connectors/registry.js";
+import { getConnectorCacheDir } from "../core/paths.js";
+export { createPersonalServerClient } from "./client.js";
 const DEFAULT_PORTS = [8080, 8081, 8082, 8083, 8084, 8085];
 export async function detectPersonalServerTarget() {
+    // 1. Persisted config (highest priority)
+    const config = await readCliConfig();
+    if (config.personalServerUrl) {
+        const health = await fetchHealth(config.personalServerUrl);
+        return {
+            state: health ? "available" : "unavailable",
+            url: config.personalServerUrl,
+            source: "config",
+            health,
+        };
+    }
+    // 2. Environment variable
     const explicitUrl = process.env.VANA_PERSONAL_SERVER_URL;
     if (explicitUrl) {
-        return (await canReachPersonalServer(explicitUrl))
-            ? { state: "available", url: explicitUrl }
-            : { state: "unavailable", url: explicitUrl };
+        const health = await fetchHealth(explicitUrl);
+        return {
+            state: health ? "available" : "unavailable",
+            url: explicitUrl,
+            source: "env",
+            health,
+        };
     }
+    // 3. Localhost port scan
     for (const port of DEFAULT_PORTS) {
         const url = `http://localhost:${port}`;
-        if (await canReachPersonalServer(url)) {
-            return { state: "available", url };
+        const health = await fetchHealth(url);
+        if (health) {
+            return { state: "available", url, source: "scan", health };
         }
     }
-    return { state: "unavailable", url: null };
+    return { state: "unavailable", url: null, source: null, health: null };
 }
 export async function ingestResult(source, resultPath, target) {
     if (target.state !== "available" || !target.url) {
@@ -27,50 +51,73 @@ export async function ingestResult(source, resultPath, target) {
     }
     const raw = await fs.readFile(resultPath, "utf8");
     const result = JSON.parse(raw);
-    const scopes = Object.keys(result).filter((key) => key.includes(".") &&
-        !["exportSummary", "timestamp", "version", "platform"].includes(key));
+    const metadata = await readCachedConnectorMetadata(source, getConnectorCacheDir());
+    const scopeMappings = resolveScopes(source, result, metadata);
+    if (scopeMappings.length === 0) {
+        return [
+            {
+                type: "ingest-skipped",
+                source,
+                reason: "no_scopes_resolved",
+            },
+        ];
+    }
+    const client = createPersonalServerClient({ url: target.url });
     const events = [
-        {
-            type: "ingest-started",
-            source,
-            target: target.url,
-        },
+        { type: "ingest-started", source, target: target.url },
     ];
-    try {
-        for (const scope of scopes) {
-            const response = await fetch(`${target.url}/v1/data/${scope}`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(result[scope]),
-            });
-            if (!response.ok) {
-                throw new Error(`Ingest failed for ${scope}: ${response.status}`);
-            }
-        }
+    const scopeResults = [];
+    for (const mapping of scopeMappings) {
+        const scopeResult = await client.ingestScope(mapping.scope, mapping.data);
+        scopeResults.push(scopeResult);
+    }
+    const allStored = scopeResults.every((r) => r.status === "stored");
+    const allFailed = scopeResults.every((r) => r.status === "failed");
+    if (allStored) {
         events.push({
             type: "ingest-complete",
             source,
             target: target.url,
+            scopeResults,
         });
-        return events;
     }
-    catch (error) {
+    else if (allFailed) {
         events.push({
             type: "ingest-failed",
             source,
             target: target.url,
-            message: error instanceof Error ? error.message : "Ingest failed.",
+            message: scopeResults.map((r) => `${r.scope}: ${r.error}`).join("; "),
+            scopeResults,
         });
-        return events;
     }
+    else {
+        events.push({
+            type: "ingest-partial",
+            source,
+            target: target.url,
+            scopeResults,
+        });
+    }
+    return events;
 }
-async function canReachPersonalServer(baseUrl) {
+async function fetchHealth(baseUrl) {
     try {
-        const response = await fetch(`${baseUrl}/health`, { method: "GET" });
-        return response.ok;
+        const response = await fetch(`${baseUrl}/health`, {
+            method: "GET",
+            signal: AbortSignal.timeout(2_000),
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return {
+            status: typeof body.status === "string" ? body.status : "unknown",
+            version: typeof body.version === "string" ? body.version : "unknown",
+            uptime: typeof body.uptime === "number" ? body.uptime : 0,
+            owner: typeof body.owner === "string" ? body.owner : null,
+        };
     }
     catch {
-        return false;
+        return null;
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/personal-server/index.js.map

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

package/dist/personal-server/scope-resolver.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectorMetadata } from "../connectors/registry.js";
+export interface ScopeMapping {
+    scope: string;
+    data: unknown;
+}
+/**
+ * Resolve connector output keys to personal server scopes.
+ *
+ * Strategy (matches DataConnect production):
+ * 1. If any output keys contain ".", use them directly as scopes
+ * 2. Otherwise, use connector metadata to map: metadata scope "github.profile"
+ *    → look for key "profile" in result
+ * 3. If no metadata, fall back to "{source}.{key}" for every non-metadata key
+ *    (exclude: exportSummary, timestamp, version, platform)
+ *
+ * @param source - The connector source name (e.g. "github")
+ * @param result - The connector output as key-value pairs
+ * @param metadata - Optional connector metadata with scope definitions
+ * @returns An array of scope mappings
+ */
+export declare function resolveScopes(source: string, result: Record<string, unknown>, metadata: ConnectorMetadata | null): ScopeMapping[];
+//# sourceMappingURL=scope-resolver.d.ts.map

package/dist/personal-server/scope-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.d.ts","sourceRoot":"","sources":["../../src/personal-server/scope-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,YAAY,EAAE,CAmChB"}

package/dist/personal-server/scope-resolver.js

@@ -0,0 +1,68 @@
+/** Keys that are connector metadata, not user data. */
+const EXCLUDED_KEYS = new Set([
+    "exportSummary",
+    "timestamp",
+    "version",
+    "platform",
+]);
+/**
+ * Ensure scope data is a JSON object for the Personal Server API.
+ * Arrays are wrapped as `{ items: [...] }`. Primitives are wrapped
+ * as `{ value: ... }`. Objects pass through unchanged.
+ */
+function ensureObject(data) {
+    if (Array.isArray(data)) {
+        return { items: data };
+    }
+    if (data !== null && typeof data === "object") {
+        return data;
+    }
+    return { value: data };
+}
+/**
+ * Resolve connector output keys to personal server scopes.
+ *
+ * Strategy (matches DataConnect production):
+ * 1. If any output keys contain ".", use them directly as scopes
+ * 2. Otherwise, use connector metadata to map: metadata scope "github.profile"
+ *    → look for key "profile" in result
+ * 3. If no metadata, fall back to "{source}.{key}" for every non-metadata key
+ *    (exclude: exportSummary, timestamp, version, platform)
+ *
+ * @param source - The connector source name (e.g. "github")
+ * @param result - The connector output as key-value pairs
+ * @param metadata - Optional connector metadata with scope definitions
+ * @returns An array of scope mappings
+ */
+export function resolveScopes(source, result, metadata) {
+    const keys = Object.keys(result);
+    // Strategy 1: If any keys are already dotted scopes, use them directly.
+    const dottedKeys = keys.filter((key) => key.includes(".") && !EXCLUDED_KEYS.has(key));
+    if (dottedKeys.length > 0) {
+        return dottedKeys.map((key) => ({
+            scope: key,
+            data: ensureObject(result[key]),
+        }));
+    }
+    // Strategy 2: Use metadata scopes to map flat keys.
+    if (metadata?.scopes && metadata.scopes.length > 0) {
+        const mappings = [];
+        for (const { scope } of metadata.scopes) {
+            // Extract the key portion after the dot, e.g. "github.profile" → "profile"
+            const dotIndex = scope.indexOf(".");
+            const key = dotIndex >= 0 ? scope.slice(dotIndex + 1) : scope;
+            if (key in result) {
+                mappings.push({ scope, data: ensureObject(result[key]) });
+            }
+        }
+        return mappings;
+    }
+    // Strategy 3: Fall back to "{source}.{key}" for every non-metadata key.
+    return keys
+        .filter((key) => !EXCLUDED_KEYS.has(key))
+        .map((key) => ({
+        scope: `${source}.${key}`,
+        data: ensureObject(result[key]),
+    }));
+}
+//# sourceMappingURL=scope-resolver.js.map

package/dist/personal-server/scope-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.js","sourceRoot":"","sources":["../../src/personal-server/scope-resolver.ts"],"names":[],"mappings":"AAOA,uDAAuD;AACvD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,eAAe;IACf,WAAW;IACX,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAa;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,IAA+B,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,MAA+B,EAC/B,QAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,wEAAwE;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CACtD,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACxC,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9D,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wEAAwE;IACxE,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,GAAG,MAAM,IAAI,GAAG,EAAE;QACzB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;KAChC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/runtime/core/contracts.d.ts

@@ -0,0 +1,84 @@
+export interface RuntimeNeedInputEvent {
+    type: "needs-input";
+    source: string;
+    message: string;
+    fields: string[];
+    logPath: string;
+    schema?: {
+        properties?: Record<string, unknown>;
+    };
+    pendingInputPath?: string;
+    responseInputPath?: string;
+}
+export interface RuntimeRunStartedEvent {
+    type: "run-started";
+    source: string;
+    logPath: string;
+}
+export interface RuntimeLegacyAuthEvent {
+    type: "legacy-auth";
+    source: string;
+    message: string;
+    logPath: string;
+}
+export interface RuntimeHeadedRequiredEvent {
+    type: "headed-required";
+    source: string;
+    message: string;
+    logPath: string;
+    url?: string;
+}
+export interface RuntimeCollectionCompleteEvent {
+    type: "collection-complete";
+    source: string;
+    resultPath: string;
+    logPath: string;
+}
+export interface RuntimeProgressEvent {
+    type: "progress-update";
+    source: string;
+    logPath: string;
+    message?: string;
+    count?: number;
+    phase?: unknown;
+}
+export interface RuntimeStatusEvent {
+    type: "status-update";
+    source: string;
+    logPath: string;
+    message: string;
+}
+export interface RuntimeErrorEvent {
+    type: "runtime-error";
+    source: string;
+    message: string;
+    logPath: string;
+}
+export type RuntimeEvent = RuntimeRunStartedEvent | RuntimeNeedInputEvent | RuntimeHeadedRequiredEvent | RuntimeLegacyAuthEvent | RuntimeCollectionCompleteEvent | RuntimeProgressEvent | RuntimeStatusEvent | RuntimeErrorEvent;
+export interface RuntimeInputRequest {
+    message?: string;
+    schema?: {
+        properties?: Record<string, unknown>;
+    };
+    fields: string[];
+    responseInputPath: string;
+}
+export interface ConnectorRunRequest {
+    connectorPath: string;
+    source: string;
+    noInput?: boolean;
+    signal?: AbortSignal;
+    onNeedInput?: (event: RuntimeInputRequest) => Promise<Record<string, string>>;
+}
+export interface ConnectorRunHandle {
+    readonly source: string;
+    readonly logPath: string;
+    events(): AsyncGenerator<RuntimeEvent, void, void>;
+    stop(reason?: string): void;
+}
+export interface RuntimeCapabilities {
+    supportsHeaded: boolean;
+    supportsManagedProfiles: boolean;
+    supportsScreenshots: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/runtime/core/contracts.d.ts.map

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

package/dist/runtime/core/contracts.js

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