npm - @zackbart/connecta - Versions diffs - 0.1.0 - Mend

@zackbart/connecta 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/CHANGELOG.md +13 -0
package/LICENSE +21 -0
package/README.md +249 -0
package/SECURITY.md +25 -0
package/assets/connecta-clay-hero.png +0 -0
package/dist/activity.d.ts +82 -0
package/dist/activity.d.ts.map +1 -0
package/dist/activity.js +51 -0
package/dist/activity.js.map +1 -0
package/dist/auth/bearer.d.ts +10 -0
package/dist/auth/bearer.d.ts.map +1 -0
package/dist/auth/bearer.js +47 -0
package/dist/auth/bearer.js.map +1 -0
package/dist/auth/clerk.d.ts +20 -0
package/dist/auth/clerk.d.ts.map +1 -0
package/dist/auth/clerk.js +167 -0
package/dist/auth/clerk.js.map +1 -0
package/dist/auth/downstream-oauth.d.ts +78 -0
package/dist/auth/downstream-oauth.d.ts.map +1 -0
package/dist/auth/downstream-oauth.js +180 -0
package/dist/auth/downstream-oauth.js.map +1 -0
package/dist/catalog.d.ts +11 -0
package/dist/catalog.d.ts.map +1 -0
package/dist/catalog.js +144 -0
package/dist/catalog.js.map +1 -0
package/dist/connectors/api.d.ts +34 -0
package/dist/connectors/api.d.ts.map +1 -0
package/dist/connectors/api.js +36 -0
package/dist/connectors/api.js.map +1 -0
package/dist/connectors/remote-mcp.d.ts +33 -0
package/dist/connectors/remote-mcp.d.ts.map +1 -0
package/dist/connectors/remote-mcp.js +255 -0
package/dist/connectors/remote-mcp.js.map +1 -0
package/dist/credentials.d.ts +33 -0
package/dist/credentials.d.ts.map +1 -0
package/dist/credentials.js +177 -0
package/dist/credentials.js.map +1 -0
package/dist/execute.d.ts +40 -0
package/dist/execute.d.ts.map +1 -0
package/dist/execute.js +424 -0
package/dist/execute.js.map +1 -0
package/dist/executors/quickjs.d.ts +26 -0
package/dist/executors/quickjs.d.ts.map +1 -0
package/dist/executors/quickjs.js +267 -0
package/dist/executors/quickjs.js.map +1 -0
package/dist/favicon.d.ts +2 -0
package/dist/favicon.d.ts.map +1 -0
package/dist/favicon.js +49 -0
package/dist/favicon.js.map +1 -0
package/dist/index.d.ts +85 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +73 -0
package/dist/index.js.map +1 -0
package/dist/mcp-result.d.ts +9 -0
package/dist/mcp-result.d.ts.map +1 -0
package/dist/mcp-result.js +35 -0
package/dist/mcp-result.js.map +1 -0
package/dist/meta-tools.d.ts +100 -0
package/dist/meta-tools.d.ts.map +1 -0
package/dist/meta-tools.js +797 -0
package/dist/meta-tools.js.map +1 -0
package/dist/node.d.ts +9 -0
package/dist/node.d.ts.map +1 -0
package/dist/node.js +57 -0
package/dist/node.js.map +1 -0
package/dist/registry.d.ts +78 -0
package/dist/registry.d.ts.map +1 -0
package/dist/registry.js +299 -0
package/dist/registry.js.map +1 -0
package/dist/server.d.ts +31 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +543 -0
package/dist/server.js.map +1 -0
package/dist/skills.d.ts +8 -0
package/dist/skills.d.ts.map +1 -0
package/dist/skills.js +60 -0
package/dist/skills.js.map +1 -0
package/dist/storage/file.d.ts +8 -0
package/dist/storage/file.d.ts.map +1 -0
package/dist/storage/file.js +53 -0
package/dist/storage/file.js.map +1 -0
package/dist/storage/memory.d.ts +4 -0
package/dist/storage/memory.d.ts.map +1 -0
package/dist/storage/memory.js +29 -0
package/dist/storage/memory.js.map +1 -0
package/dist/types.d.ts +219 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +3 -0
package/dist/types.js.map +1 -0
package/dist/ui.d.ts +91 -0
package/dist/ui.d.ts.map +1 -0
package/dist/ui.js +1031 -0
package/dist/ui.js.map +1 -0
package/package.json +96 -0
package/src/activity.ts +144 -0
package/src/auth/bearer.ts +54 -0
package/src/auth/clerk.ts +226 -0
package/src/auth/downstream-oauth.ts +202 -0
package/src/catalog.ts +166 -0
package/src/connectors/api.ts +80 -0
package/src/connectors/remote-mcp.ts +324 -0
package/src/credentials.ts +259 -0
package/src/execute.ts +550 -0
package/src/executors/quickjs.ts +321 -0
package/src/favicon.ts +53 -0
package/src/index.ts +197 -0
package/src/mcp-result.ts +43 -0
package/src/meta-tools.ts +1120 -0
package/src/node.ts +62 -0
package/src/registry.ts +400 -0
package/src/server.ts +758 -0
package/src/skills.ts +63 -0
package/src/storage/file.ts +62 -0
package/src/storage/memory.ts +34 -0
package/src/types.ts +254 -0
package/src/ui.ts +1121 -0

package/dist/server.js ADDED Viewed

@@ -0,0 +1,543 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { registerExecuteTool } from "./execute.js";
+import { registerMetaTools } from "./meta-tools.js";
+import { CONNECTA_INSTRUCTIONS } from "./skills.js";
+import { InvalidActivityCursorError } from "./activity.js";
+import { CONNECTA_FAVICON_ICO } from "./favicon.js";
+import { buildUiData, CONNECTA_FAVICON_SVG, resolveBranding, renderUiHtml, } from "./ui.js";
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type, Authorization, mcp-protocol-version, mcp-session-id",
+};
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function escapeHtml(s) {
+    return s
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+/** `body` is escaped — callback params and error messages are attacker-influenced. */
+function html(body, status = 200, branding) {
+    const brand = resolveBranding(branding);
+    const title = brand.ownerName
+        ? `${brand.productName} — ${brand.ownerName}`
+        : brand.productName;
+    const owner = brand.ownerName
+        ? brand.ownerUrl
+            ? `<a class="brand" href="${escapeHtml(brand.ownerUrl)}">${escapeHtml(brand.ownerName)}</a>`
+            : `<span class="brand">${escapeHtml(brand.ownerName)}</span>`
+        : `<span class="brand">${escapeHtml(brand.productName)}</span>`;
+    const product = brand.ownerName
+        ? `<span class="product">${escapeHtml(brand.productName)}</span>`
+        : "";
+    return new Response(`<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<meta name="theme-color" content="#ffffff">
+<link rel="icon" href="/favicon.svg" type="image/svg+xml">
+<link rel="shortcut icon" href="/favicon.ico">
+<title>${escapeHtml(title)}</title>
+<style>
+  * { border-radius: 0; box-sizing: border-box; }
+  html { color: #000; background: #fff; font: 16px/1.5 "Helvetica Neue",
+    Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; }
+  body { margin: 0; min-height: 100vh; }
+  ::selection { color: #fff; background: #000; }
+  .shell { margin: 0 auto; max-width: 70rem; padding: 1rem; }
+  .grid { display: grid; gap: 1rem 1.5rem;
+    grid-template-columns: repeat(3, minmax(0, 1fr)); }
+  .brand { font-weight: 500; grid-column: 1; text-decoration: none; }
+  .product { grid-column: 2 / -1; }
+  main { margin-top: 5rem; }
+  h1, p { font: inherit; margin: 0; }
+  h1 { grid-column: 1; }
+  .copy { grid-column: 2 / -1; max-width: 34em; }
+  .copy > * + * { margin-top: 1.5rem; }
+  a { color: inherit; text-decoration: underline; text-decoration-thickness: 1.5px;
+    text-underline-offset: .22em; }
+  a:hover { text-decoration-color: transparent; }
+  a:focus-visible { outline: 1px solid #000; outline-offset: 2px; }
+  @media (max-width: 36.99rem) {
+    .grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+    .product { grid-column: 2; }
+    main { margin-top: 3rem; }
+    h1, .copy { grid-column: 1 / -1; }
+  }
+</style>
+</head>
+<body>
+  <header class="shell grid">
+    ${owner}
+    ${product}
+  </header>
+  <main class="shell grid">
+    <h1>Connection status</h1>
+    <div class="copy">
+      <p>${escapeHtml(body)}</p>
+      <p><a href="/ui">Return to ${escapeHtml(brand.productName)}</a></p>
+    </div>
+  </main>
+</body>
+</html>`, { status, headers: { "Content-Type": "text/html; charset=utf-8" } });
+}
+async function authorize(request, baseUrl, auth) {
+    if (auth.length === 0) {
+        return { ok: true, actor: { kind: "anonymous" } };
+    }
+    let lastResponse = null;
+    for (const provider of auth) {
+        const result = await provider.authorize(request, baseUrl);
+        if (result.ok) {
+            const subjectId = result.subjectId ?? result.userId;
+            return {
+                ok: true,
+                actor: {
+                    kind: provider.kind,
+                    ...(subjectId ? { id: subjectId } : {}),
+                },
+                providerKind: provider.kind,
+                ...(result.userId ? { userId: result.userId } : {}),
+            };
+        }
+        lastResponse = result.response;
+    }
+    return {
+        ok: false,
+        response: lastResponse ??
+            new Response(JSON.stringify({ error: "unauthorized" }), {
+                status: 401,
+                headers: {
+                    "Content-Type": "application/json",
+                    "WWW-Authenticate": "Bearer",
+                },
+            }),
+    };
+}
+function privateJson(body, init = {}) {
+    const headers = new Headers(init.headers);
+    headers.set("Content-Type", "application/json");
+    headers.set("Cache-Control", "no-store");
+    headers.set("Referrer-Policy", "no-referrer");
+    return new Response(JSON.stringify(body), { ...init, headers });
+}
+// Browser-based MCP clients call /mcp cross-origin. Without CORS on every
+// response — errors included — the browser hides the 401, the client cannot
+// read WWW-Authenticate, and OAuth discovery silently never starts.
+function withMcpCors(response) {
+    const headers = new Headers(response.headers);
+    for (const [name, value] of Object.entries(CORS_HEADERS)) {
+        headers.set(name, value);
+    }
+    headers.set("Access-Control-Expose-Headers", "WWW-Authenticate, mcp-session-id, mcp-protocol-version");
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+function withSecurityHeaders(response, requestUrl, path) {
+    const headers = new Headers(response.headers);
+    headers.set("X-Content-Type-Options", "nosniff");
+    headers.set("Referrer-Policy", "no-referrer");
+    if (requestUrl.protocol === "https:") {
+        headers.set("Strict-Transport-Security", "max-age=31536000");
+    }
+    if (path === "/ui") {
+        // A directive-only CSP does not interfere with the UI's existing scripts,
+        // while preventing the authenticated operator surface from being framed.
+        headers.set("Content-Security-Policy", "frame-ancestors 'none'");
+        headers.set("X-Frame-Options", "DENY");
+    }
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+async function authorizeUiAdmin(request, baseUrl, auth) {
+    // Credential mutation is intentionally narrower than /mcp and /ui/data:
+    // only the interactive Clerk provider may admit it. A static bearer token is
+    // useful for headless tool calls but must not become a vault-admin key.
+    const provider = auth.find((candidate) => candidate.uiAuth?.kind === "clerk");
+    if (!provider) {
+        return {
+            ok: false,
+            response: privateJson({ error: "credential management requires Clerk authentication" }, { status: 403 }),
+        };
+    }
+    const result = await provider.authorize(request, baseUrl);
+    if (!result.ok)
+        return result;
+    if (!result.userId) {
+        return {
+            ok: false,
+            response: privateJson({ error: "authenticated user required" }, { status: 403 }),
+        };
+    }
+    return { ok: true, userId: result.userId };
+}
+function isSameOrigin(request, baseUrl) {
+    const origin = request.headers.get("origin");
+    if (!origin)
+        return false;
+    try {
+        return new URL(origin).origin === new URL(baseUrl).origin;
+    }
+    catch {
+        return false;
+    }
+}
+async function readCredentialInput(request, config) {
+    if (!request.headers
+        .get("content-type")
+        ?.toLowerCase()
+        .startsWith("application/json")) {
+        return {
+            ok: false,
+            response: privateJson({ error: "Content-Type must be application/json" }, { status: 415 }),
+        };
+    }
+    const raw = await request.text();
+    if (raw.length > 20_000) {
+        return {
+            ok: false,
+            response: privateJson({ error: "request body is too large" }, { status: 413 }),
+        };
+    }
+    try {
+        const body = JSON.parse(raw);
+        if (!config.fields?.length) {
+            if (typeof body.value !== "string" || !body.value.trim()) {
+                return {
+                    ok: false,
+                    response: privateJson({ error: "value must be a non-empty string" }, { status: 400 }),
+                };
+            }
+            return { ok: true, input: { kind: "single", value: body.value } };
+        }
+        if (!body.values ||
+            typeof body.values !== "object" ||
+            Array.isArray(body.values)) {
+            return {
+                ok: false,
+                response: privateJson({ error: "values must be an object" }, { status: 400 }),
+            };
+        }
+        const rawValues = body.values;
+        const expected = new Set(config.fields.map((field) => field.name));
+        const unexpected = Object.keys(rawValues).find((field) => !expected.has(field));
+        if (unexpected) {
+            return {
+                ok: false,
+                response: privateJson({ error: `unexpected credential field "${unexpected}"` }, { status: 400 }),
+            };
+        }
+        const values = {};
+        for (const field of config.fields) {
+            const value = rawValues[field.name];
+            if (typeof value !== "string" || !value.trim()) {
+                return {
+                    ok: false,
+                    response: privateJson({ error: `${field.name} must be a non-empty string` }, { status: 400 }),
+                };
+            }
+            values[field.name] = value;
+        }
+        return { ok: true, input: { kind: "multiple", values } };
+    }
+    catch {
+        return {
+            ok: false,
+            response: privateJson({ error: "invalid JSON body" }, { status: 400 }),
+        };
+    }
+}
+async function handleCredentialRequest(request, connectorId, action, opts, baseUrl) {
+    if (!opts.credentialVault) {
+        return privateJson({ error: "credential storage is not configured" }, { status: 503 });
+    }
+    if (!isSameOrigin(request, baseUrl)) {
+        return privateJson({ error: "same-origin request required" }, { status: 403 });
+    }
+    const admin = await authorizeUiAdmin(request, baseUrl, opts.auth);
+    if (!admin.ok)
+        return admin.response;
+    const connector = opts.registry.getConnector(connectorId);
+    if (!connector?.credential) {
+        return privateJson({ error: "unknown credential slot" }, { status: 404 });
+    }
+    if (action === "test") {
+        if (request.method !== "POST") {
+            return privateJson({ error: "method not allowed" }, { status: 405 });
+        }
+        if (!connector.testCredential && !connector.testCredentials) {
+            return privateJson({ error: "this connector does not support credential testing" }, { status: 400 });
+        }
+        try {
+            const ctx = opts.registry.contextFor(connectorId, baseUrl);
+            let result;
+            if (connector.testCredentials) {
+                const values = await opts.credentialVault.getAll(connectorId);
+                if (!values) {
+                    return privateJson({ error: "configure the credentials before testing them" }, { status: 409 });
+                }
+                result = await connector.testCredentials(values, ctx);
+            }
+            else {
+                const value = await opts.credentialVault.get(connectorId);
+                if (!value) {
+                    return privateJson({ error: "configure the credential before testing it" }, { status: 409 });
+                }
+                result = await connector.testCredential(value, ctx);
+            }
+            return privateJson(result);
+        }
+        catch (err) {
+            return privateJson({ ok: false, message: msg(err) });
+        }
+    }
+    if (action) {
+        return privateJson({ error: "not found" }, { status: 404 });
+    }
+    if (request.method === "PUT") {
+        const input = await readCredentialInput(request, connector.credential);
+        if (!input.ok)
+            return input.response;
+        try {
+            const metadata = input.input.kind === "single"
+                ? await opts.credentialVault.set(connectorId, input.input.value, admin.userId)
+                : await opts.credentialVault.setAll(connectorId, input.input.values, admin.userId);
+            opts.registry.invalidate(connectorId);
+            return privateJson({ credential: metadata });
+        }
+        catch (err) {
+            return privateJson({ error: msg(err) }, { status: 400 });
+        }
+    }
+    if (request.method === "DELETE") {
+        await opts.credentialVault.delete(connectorId);
+        opts.registry.invalidate(connectorId);
+        return new Response(null, {
+            status: 204,
+            headers: {
+                "Cache-Control": "no-store",
+                "Referrer-Policy": "no-referrer",
+            },
+        });
+    }
+    return privateJson({ error: "method not allowed" }, { status: 405 });
+}
+async function serveMcp(request, opts, baseUrl, actor, runtimeContext) {
+    // Fresh McpServer + transport per request (SDK ≥1.26 requirement), stateless.
+    const server = new McpServer(opts.serverInfo, {
+        instructions: CONNECTA_INSTRUCTIONS,
+    });
+    const activity = opts.activity
+        ? {
+            sink: opts.activity,
+            actor,
+            requestId: crypto.randomUUID(),
+            serverInfo: opts.serverInfo,
+            ...(opts.activityDeploymentId
+                ? { deploymentId: opts.activityDeploymentId }
+                : {}),
+            ...(runtimeContext?.waitUntil
+                ? { defer: runtimeContext.waitUntil.bind(runtimeContext) }
+                : {}),
+            logger: opts.logger,
+        }
+        : undefined;
+    registerMetaTools(server, opts.registry, { baseUrl, activity });
+    if (opts.executor) {
+        registerExecuteTool(server, opts.registry, {
+            baseUrl,
+            executor: opts.executor,
+            logger: opts.logger,
+            activity,
+        });
+    }
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        enableJsonResponse: true,
+    });
+    await server.connect(transport);
+    return transport.handleRequest(request);
+}
+async function handleOAuthCallback(url, registry, baseUrl, branding) {
+    const id = url.pathname.slice("/oauth/callback/".length);
+    const connector = registry.getConnector(id);
+    if (!connector || !connector.finishAuth) {
+        return html(`Unknown connector "${id}".`, 404, branding);
+    }
+    const error = url.searchParams.get("error");
+    if (error)
+        return html(`Authorization denied: ${error}`, 400, branding);
+    const code = url.searchParams.get("code");
+    if (!code)
+        return html("Missing authorization code.", 400, branding);
+    const context = registry.contextFor(id, baseUrl);
+    // CSRF / login-fixation guard: this route is intentionally public, so verify
+    // the `state` matches the flow connecta started BEFORE exchanging the code.
+    if (connector.verifyState) {
+        const state = url.searchParams.get("state");
+        const ok = await connector.verifyState(state, context);
+        if (!ok) {
+            return html("Authorization state mismatch — this callback did not originate from " +
+                "a flow started by connecta. Re-run authorization and try again.", 400, branding);
+        }
+    }
+    try {
+        await connector.finishAuth(code, context);
+        await registry.invalidateStored(id);
+        return html(`Connected "${id}". You can close this window.`, 200, branding);
+    }
+    catch (err) {
+        return html(`Authorization failed: ${msg(err)}`, 500, branding);
+    }
+}
+/** Build the Web-standard fetch handler that serves connecta. */
+export function createFetchHandler(opts) {
+    const { registry, auth, publicUrl, serverInfo } = opts;
+    return async function fetch(request, runtimeContext) {
+        const url = new URL(request.url);
+        const baseUrl = publicUrl ?? url.origin;
+        const path = url.pathname;
+        if (publicUrl &&
+            new URL(publicUrl).protocol === "https:" &&
+            url.protocol === "http:") {
+            const target = new URL(`${url.pathname}${url.search}`, publicUrl);
+            return withSecurityHeaders(new Response(null, {
+                status: 308,
+                headers: { Location: target.toString() },
+            }), url, path);
+        }
+        const route = async () => {
+            const credentialMatch = /^\/ui\/credentials\/([a-z0-9_-]+)(?:\/([a-z]+))?$/.exec(path);
+            if (credentialMatch) {
+                // Never opt these mutation routes into the server's wildcard CORS
+                // preflight behavior.
+                if (request.method === "OPTIONS") {
+                    return privateJson({ error: "method not allowed" }, { status: 405 });
+                }
+                return handleCredentialRequest(request, credentialMatch[1], credentialMatch[2], opts, baseUrl);
+            }
+            if (request.method === "OPTIONS") {
+                for (const a of auth) {
+                    if (a.handleMetadata) {
+                        const r = await a.handleMetadata(request, baseUrl);
+                        if (r)
+                            return r;
+                    }
+                }
+                return new Response(null, { status: 204, headers: CORS_HEADERS });
+            }
+            if (path.startsWith("/.well-known/")) {
+                for (const a of auth) {
+                    if (a.handleMetadata) {
+                        const r = await a.handleMetadata(request, baseUrl);
+                        if (r)
+                            return r;
+                    }
+                }
+                return new Response("Not Found", { status: 404 });
+            }
+            if (path === "/health") {
+                return Response.json({
+                    status: "ok",
+                    connectors: registry.listConnectors().length,
+                    server: opts.serverInfo,
+                    ...(opts.deploymentInfo ? { deployment: opts.deploymentInfo } : {}),
+                });
+            }
+            if (path.startsWith("/oauth/callback/")) {
+                return handleOAuthCallback(url, registry, baseUrl, opts.branding);
+            }
+            if (request.method === "GET" && path === "/favicon.svg") {
+                return new Response(CONNECTA_FAVICON_SVG, {
+                    headers: {
+                        "Content-Type": "image/svg+xml",
+                        "Cache-Control": "public, max-age=86400",
+                    },
+                });
+            }
+            if (request.method === "GET" && path === "/favicon.ico") {
+                return new Response(CONNECTA_FAVICON_ICO, {
+                    headers: {
+                        "Content-Type": "image/x-icon",
+                        "Cache-Control": "public, max-age=86400",
+                    },
+                });
+            }
+            if (path === "/ui") {
+                // Open shell — carries no data; data comes only from the gated /ui/data.
+                const uiAuth = auth.find((provider) => provider.uiAuth)?.uiAuth;
+                const mcpUrl = new URL("/mcp", baseUrl).toString();
+                return new Response(renderUiHtml(uiAuth, mcpUrl, opts.branding), {
+                    status: 200,
+                    headers: { "Content-Type": "text/html; charset=utf-8" },
+                });
+            }
+            if (path === "/ui/data") {
+                const authz = await authorize(request, baseUrl, auth);
+                if (!authz.ok)
+                    return authz.response;
+                const data = await buildUiData(registry, baseUrl, serverInfo,
+                // The static headless bearer may read connector health, but only a
+                // Clerk-authenticated operator receives credential metadata.
+                authz.providerKind === "clerk" && authz.userId
+                    ? opts.credentialVault
+                    : undefined, Boolean(opts.activity?.list));
+                return privateJson(data);
+            }
+            if (path === "/ui/activity") {
+                if (request.method !== "GET") {
+                    return privateJson({ error: "method not allowed" }, { status: 405 });
+                }
+                const authz = await authorize(request, baseUrl, auth);
+                if (!authz.ok)
+                    return authz.response;
+                if (opts.activityReadGate &&
+                    !(await opts.activityReadGate(authz.actor))) {
+                    return privateJson({ error: "forbidden" }, { status: 403 });
+                }
+                if (!opts.activity?.list) {
+                    return privateJson({ error: "activity history is not configured" }, { status: 404 });
+                }
+                const cursor = url.searchParams.get("cursor") ?? undefined;
+                if (cursor && cursor.length > 500) {
+                    return privateJson({ error: "invalid cursor" }, { status: 400 });
+                }
+                const requestedLimit = Number(url.searchParams.get("limit") ?? "50");
+                const limit = Number.isFinite(requestedLimit)
+                    ? Math.min(100, Math.max(1, Math.trunc(requestedLimit)))
+                    : 50;
+                try {
+                    return privateJson(await opts.activity.list({ cursor, limit }));
+                }
+                catch (error) {
+                    if (error instanceof InvalidActivityCursorError) {
+                        return privateJson({ error: error.message }, { status: 400 });
+                    }
+                    opts.logger.error("[connecta] activity read failed", error);
+                    return privateJson({ error: "activity history is temporarily unavailable" }, { status: 503 });
+                }
+            }
+            if (path === "/mcp") {
+                const authz = await authorize(request, baseUrl, auth);
+                const response = authz.ok
+                    ? await serveMcp(request, opts, baseUrl, authz.actor, runtimeContext)
+                    : authz.response;
+                return withMcpCors(response);
+            }
+            return new Response("Not Found", { status: 404 });
+        };
+        return withSecurityHeaders(await route(), url, path);
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/skills.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+export declare const CONNECTA_INSTRUCTIONS = "Connecta exposes many integrations behind meta-tools. When an address is unknown, start with search_tools and includeSchemas=\"compact\"; use describe_tools only when that schema is insufficient. Use call_tool for one explicitly read-only call, batch_call for 2\u201310 independent explicitly read-only calls, and execute_code (when available) only for dependent read-only steps, loops, joins, or reducing large results. Unannotated, write-capable, and destructive tools must use call_destructive_tool individually. Use authorize_connector only after auth_required and get_result only for truncated results. For the detailed workflow, call skills({ name: \"usage\" }) once per task.";
+export declare const USAGE_SKILL = "# Connecta usage\n\n## Choose the smallest execution tool\n\n- Unknown address: `search_tools({ query, includeSchemas: \"compact\" })`.\n- Schema still unclear: `describe_tools({ addresses: [...] })`.\n- One explicitly read-only call: `call_tool`.\n- Two to ten independent explicitly read-only calls: `batch_call`.\n- Dependent read-only calls, loops, joins, branching, or large-result reduction: `execute_code` when available.\n- Any unannotated, write-capable, or destructive call: `call_destructive_tool`, individually and only after reviewing its schema and consequences.\n- Truncated result: retry with `fields` when possible; otherwise page it with `get_result`.\n- `auth_required`: use `authorize_connector`, have the operator complete consent, then confirm with `list_connectors`.\n\nUse `list_connectors({ probe: false })` for a fast inventory. Use `probe: true` only when diagnosing live health or authorization.\n\n## Code mode\n\nUse code mode when a later call depends on an earlier result, when joining across connectors, or when filtering or aggregating data in the sandbox will substantially shrink the response. Use `Promise.all` or `connecta.batch` for independent calls inside one execution.\n\nDo not use code mode for one straightforward call, for independent calls already handled by `batch_call`, or for any tool not explicitly annotated `readOnlyHint: true`. Code mode has a bounded host-call budget and per-call deadline. Return only the reduced value the agent needs; do not return a large upstream payload unchanged.\n\n## Examples\n\nThese addresses are illustrative; always use the exact address returned by `search_tools`.\n\nSingle call:\n```json\n{ \"address\": \"crm.get_account\", \"args\": { \"id\": \"acct_123\" }, \"resultMode\": \"value\" }\n```\n\nIndependent calls:\n```json\n{ \"calls\": [\n  { \"address\": \"crm.get_account\", \"args\": { \"id\": \"acct_123\" } },\n  { \"address\": \"billing.list_invoices\", \"args\": { \"status\": \"open\" } }\n] }\n```\n\nDependent code with reduction:\n```js\nasync () => {\n  const accounts = await crm.search_accounts({ query: \"renewal\" });\n  const details = await Promise.all(\n    accounts.results.slice(0, 5).map((account) =>\n      crm.get_account({ id: account.id })\n    )\n  );\n  return details.map(({ id, name, status }) => ({ id, name, status }));\n}\n```\n";
+export declare const AVAILABLE_SKILLS: readonly [{
+    readonly name: "usage";
+    readonly description: "How to choose among Connecta discovery, direct, batch, destructive, and code-mode tools.";
+    readonly content: "# Connecta usage\n\n## Choose the smallest execution tool\n\n- Unknown address: `search_tools({ query, includeSchemas: \"compact\" })`.\n- Schema still unclear: `describe_tools({ addresses: [...] })`.\n- One explicitly read-only call: `call_tool`.\n- Two to ten independent explicitly read-only calls: `batch_call`.\n- Dependent read-only calls, loops, joins, branching, or large-result reduction: `execute_code` when available.\n- Any unannotated, write-capable, or destructive call: `call_destructive_tool`, individually and only after reviewing its schema and consequences.\n- Truncated result: retry with `fields` when possible; otherwise page it with `get_result`.\n- `auth_required`: use `authorize_connector`, have the operator complete consent, then confirm with `list_connectors`.\n\nUse `list_connectors({ probe: false })` for a fast inventory. Use `probe: true` only when diagnosing live health or authorization.\n\n## Code mode\n\nUse code mode when a later call depends on an earlier result, when joining across connectors, or when filtering or aggregating data in the sandbox will substantially shrink the response. Use `Promise.all` or `connecta.batch` for independent calls inside one execution.\n\nDo not use code mode for one straightforward call, for independent calls already handled by `batch_call`, or for any tool not explicitly annotated `readOnlyHint: true`. Code mode has a bounded host-call budget and per-call deadline. Return only the reduced value the agent needs; do not return a large upstream payload unchanged.\n\n## Examples\n\nThese addresses are illustrative; always use the exact address returned by `search_tools`.\n\nSingle call:\n```json\n{ \"address\": \"crm.get_account\", \"args\": { \"id\": \"acct_123\" }, \"resultMode\": \"value\" }\n```\n\nIndependent calls:\n```json\n{ \"calls\": [\n  { \"address\": \"crm.get_account\", \"args\": { \"id\": \"acct_123\" } },\n  { \"address\": \"billing.list_invoices\", \"args\": { \"status\": \"open\" } }\n] }\n```\n\nDependent code with reduction:\n```js\nasync () => {\n  const accounts = await crm.search_accounts({ query: \"renewal\" });\n  const details = await Promise.all(\n    accounts.results.slice(0, 5).map((account) =>\n      crm.get_account({ id: account.id })\n    )\n  );\n  return details.map(({ id, name, status }) => ({ id, name, status }));\n}\n```\n";
+}];
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,+qBACmoB,CAAC;AAEtqB,eAAO,MAAM,WAAW,wzEAkDvB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;EAOnB,CAAC"}

package/dist/skills.js ADDED Viewed

@@ -0,0 +1,60 @@
+export const CONNECTA_INSTRUCTIONS = 'Connecta exposes many integrations behind meta-tools. When an address is unknown, start with search_tools and includeSchemas="compact"; use describe_tools only when that schema is insufficient. Use call_tool for one explicitly read-only call, batch_call for 2–10 independent explicitly read-only calls, and execute_code (when available) only for dependent read-only steps, loops, joins, or reducing large results. Unannotated, write-capable, and destructive tools must use call_destructive_tool individually. Use authorize_connector only after auth_required and get_result only for truncated results. For the detailed workflow, call skills({ name: "usage" }) once per task.';
+export const USAGE_SKILL = `# Connecta usage
+## Choose the smallest execution tool
+- Unknown address: \`search_tools({ query, includeSchemas: "compact" })\`.
+- Schema still unclear: \`describe_tools({ addresses: [...] })\`.
+- One explicitly read-only call: \`call_tool\`.
+- Two to ten independent explicitly read-only calls: \`batch_call\`.
+- Dependent read-only calls, loops, joins, branching, or large-result reduction: \`execute_code\` when available.
+- Any unannotated, write-capable, or destructive call: \`call_destructive_tool\`, individually and only after reviewing its schema and consequences.
+- Truncated result: retry with \`fields\` when possible; otherwise page it with \`get_result\`.
+- \`auth_required\`: use \`authorize_connector\`, have the operator complete consent, then confirm with \`list_connectors\`.
+Use \`list_connectors({ probe: false })\` for a fast inventory. Use \`probe: true\` only when diagnosing live health or authorization.
+## Code mode
+Use code mode when a later call depends on an earlier result, when joining across connectors, or when filtering or aggregating data in the sandbox will substantially shrink the response. Use \`Promise.all\` or \`connecta.batch\` for independent calls inside one execution.
+Do not use code mode for one straightforward call, for independent calls already handled by \`batch_call\`, or for any tool not explicitly annotated \`readOnlyHint: true\`. Code mode has a bounded host-call budget and per-call deadline. Return only the reduced value the agent needs; do not return a large upstream payload unchanged.
+## Examples
+These addresses are illustrative; always use the exact address returned by \`search_tools\`.
+Single call:
+\`\`\`json
+{ "address": "crm.get_account", "args": { "id": "acct_123" }, "resultMode": "value" }
+\`\`\`
+Independent calls:
+\`\`\`json
+{ "calls": [
+  { "address": "crm.get_account", "args": { "id": "acct_123" } },
+  { "address": "billing.list_invoices", "args": { "status": "open" } }
+] }
+\`\`\`
+Dependent code with reduction:
+\`\`\`js
+async () => {
+  const accounts = await crm.search_accounts({ query: "renewal" });
+  const details = await Promise.all(
+    accounts.results.slice(0, 5).map((account) =>
+      crm.get_account({ id: account.id })
+    )
+  );
+  return details.map(({ id, name, status }) => ({ id, name, status }));
+}
+\`\`\`
+`;
+export const AVAILABLE_SKILLS = [
+    {
+        name: "usage",
+        description: "How to choose among Connecta discovery, direct, batch, destructive, and code-mode tools.",
+        content: USAGE_SKILL,
+    },
+];
+//# sourceMappingURL=skills.js.map