mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-20 18:26:40 +01:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - The AWS connector (#22195) lets agents use AWS with credentials minted per connection. Its role method stores no AWS keys > - That method needs the customer to create an IAM role that trusts exactly one Paperclip connection, but setup only offered the generic form and a doc > - The connect API also refused the draft step this method needs, so the role method could not be set up through the UI at all > - This pull request adds a guided setup screen. Paperclip saves a draft, hands the user a prompt for their own agent that creates the role, takes back the role ARN the agent reports, and tests the same draft. CloudFormation and IAM steps are there under "Or do it by hand" > - The benefit is that a person can connect AWS without stored keys and without typing account details, using a template AWS has validated ## Linked Issues or Issue Description Refs #22195. **Subsystem affected** Connections (AWS connector setup), UI, tool-access API. **Problem or motivation** The AWS role method must save a connection before AWS can trust it. The API rejected `saveDraft` for every method except custom MCP servers, so the UI could not complete this flow. There was also no screen that showed the issuer, the subject, the trust policy or a template. **Proposed solution** - The connect API accepts `saveDraft` for methods that declare `credentialMinter`. - `GET /tool-connections/:id/aws-setup` returns the setup values and a CloudFormation template generated for that connection. - A new `AwsRoleSetup` step runs between saving the draft and testing it. The role is named after the connection and CloudFormation fills in the account, so the first form no longer asks for a role ARN; the user pastes it back once the role exists. **Alternatives considered** - A one-click CloudFormation quick-create link. Rejected: AWS accepts quick-create templates only from Amazon S3, so Paperclip would need to host a public template bucket. The screen offers a download and a console link instead. - Instructions in a doc only. Rejected: too many hand-copied values. - Asking for the role ARN up front. Rejected: the role does not exist yet, so users had to invent an ARN and then match it exactly. - Letting the user's agent report the role ARN to Paperclip itself, through a short-lived link. Not done here: it needs a new unauthenticated endpoint (and a Paperclip Cloud front-door change). The user pastes the ARN instead. ## What Changed - `packages/shared`: - The `saveDraft` validation allows methods with minted credentials. - New `AwsConnectionSetup` type. - `server/src/services/connectors/aws/setup.ts` builds the setup values: - The issuer, audience and connection subject. - The provider host and the trust policy. - A CloudFormation template with an optional identity provider (`CreateIdentityProvider`), a role named `paperclip-<connection id>`, `AccessPolicyArn` (`ReadOnlyAccess` by default for read-only connections) and `AWSMCPSignInOAuthAccessPolicy`. The account comes from CloudFormation, so the template needs no edits. - The service method `getAwsSetup` and the route `GET /api/tool-connections/{connectionId}/aws-setup`: - The route requires `connections:configure`. - It returns 422 for a connection that is not an AWS role connection. - It reports whether the issuer key is published and any role ARN already saved. - It returns `available: false` (`address_changed`) when the instance address changed after the draft was saved, since a role set up for the old address could never pass the test. - It is registered in OpenAPI. - UI: - The AWS form no longer shows a Role ARN field (it is hidden with an empty default). - `AwsRoleSetup.tsx` shows, by default, only "Set it up with your agent" (a copyable prompt that checks the AWS account, deploys the template with `aws cloudformation deploy`, and reports the role ARN) and a field to paste that ARN. "Or do it by hand" reveals the CloudFormation steps (download, console link, parameter notes, IAM acknowledgement) and the IAM console / AWS CLI steps with copyable values; the CLI commands read the account ID themselves. - It shows an access-key message when AWS cannot reach the instance, and asks the user to save again when the instance address changed. - Failed tests appear in place. AWS error codes show the server's own plain message, because the shared error copy replaces every 502 with "temporarily unavailable". - `useAwsRoleSetupStep` owns the AWS sequence; `ConnectionSetupFlow` only asks it for request options, hands back results and renders its step: - The first Connect for `aws-role` saves a draft and opens the AWS step. - "Test connection" resumes the same draft with the pasted role ARN. - Back keeps the draft, so a later Connect updates it and does not create a second one. Returning to an unfinished draft reopens the step. - Docs: the `doc/connections/AWS.md` setup section and the plan's phase table. The SDK public input pins are refreshed. ## Verification - `server/src/__tests__/aws-mcp-connector.test.ts` covers a new API-level case through the real route validation: - Saving an `aws-role` draft over HTTP works without a role ARN, and stores the keys the screen uses to reopen it. - `aws-setup` returns the issuer, subject and the connection's role name. - The template's trust condition keys equal `<issuer host>:aud` and `<issuer host>:sub`. - The template provider URL equals the issuer. - After an address change it returns `address_changed`, and saving the draft again records the new address. - An access-key connection returns 422. - No response field looks like a secret. - `ui/src/features/connections/AwsRoleSetup.test.tsx` covers: - Only the agent setup shows by default; Test connection stays off until a valid role ARN is pasted, then sends it. - A saved role ARN is filled in. - The by-hand steps and CLI commands; the agent prompt for read-only and full access. - The template download (filename and object URL cleanup). - The unreachable-instance message. - The in-place error and the address-changed message. - The AWS message mapping. - `ui/src/pages/apps/AppsConnect.test.tsx` covers the full two-step flow: the form has no Role ARN field, the first Connect sends `saveDraft: true` with no role ARN and does not finish, the AWS step loads the setup, and "Test connection" resumes `aws-draft` with the pasted role ARN and finishes. A second test reopens the step for a returning draft. - Red/green: - Removing the API change fails the API test. - Removing the draft-first wiring fails the flow test. - Totals: server AWS, OpenAPI and connector tests (75), shared `app-definitions` (42), UI connections and apps pages (1108). Typecheck is clean for shared, server, UI (except Storybook's generated catalog, which this worktree has not built) and all four server test-tree layers. - Browser, on a real dev server with an HTTPS public address: - AWS appears in Connectors with its logo. - The form has only region and access level. Connect saves the draft (reusing an earlier one) and shows only the agent prompt and the role ARN field; "Or do it by hand" reveals the CloudFormation and IAM steps. - The copied prompt names the connection's role and stack, and the template. - Test connection with a pasted role ARN showed AWS's refusal in place (no such role, placeholder issuer), as expected. An earlier run found the generic 502 copy problem, which is fixed and re-checked. - AWS CloudFormation `validate-template` (dev account, read-only) accepts the current generated template (role named after the connection) and reports `CAPABILITY_NAMED_IAM`. The screen tells the user to acknowledge it. - Not run: an agent actually running the prompt and creating a stack in AWS, and Paperclip Cloud staging. ## Risks - The feature is still behind `enableAwsConnector` (off by default). No migration. - The template creates IAM resources in the customer's account, and the customer must acknowledge that. The role trusts only this connection's subject. - If the customer already has an identity provider for the issuer and leaves `CreateIdentityProvider` at true, AWS fails the stack with a clear error. The screen explains the parameter. ## Model Used - Claude Opus 5.5 (`claude-opus-5-5`) in Claude Code, with tool use (shell, file edits, the in-app browser against a local dev server, AWS CLI `validate-template` in the dev account, an exploration subagent). ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Paperclip <noreply@paperclip.ing>
3185 lines
155 KiB
TypeScript
3185 lines
155 KiB
TypeScript
import { isCrossSiteOAuthCallbackNavigation, oauthCallbackInterstitialHtml } from "../lib/oauth-browser-return.js";
|
|
import { aiConnectionRouterPluginKey, isSamePaperclipInstance, paperclipPeerFromMcpUrl } from "@paperclipai/shared";
|
|
import { aiConnectionRouterService } from "../services/ai-connection-router.js";
|
|
import { loadPluginAppCatalog } from "../services/plugin-app-catalog.js";
|
|
import { composioAppSetupSchema, composioAppsRefreshSchema, composioAppsSyncSchema, composioAppAccountSchema } from "@paperclipai/shared";
|
|
import { aggregatorAppsSyncSchema, aggregatorAppsRefreshSchema, arcadeDiscoverySetupSchema } from "@paperclipai/shared/aggregator-apps";
|
|
import { Router, type Request, type Response } from "express";
|
|
import type { Db } from "@paperclipai/db";
|
|
import { agents, companies, connectionGrants, issues, issueThreadInteractions, toolConnectionInstalls, toolMcpAppViews } from "@paperclipai/db";
|
|
import { and, eq, or } from "drizzle-orm";
|
|
import {
|
|
APP_STORE_DEFINITIONS,
|
|
isConnectorFeatureEnabled,
|
|
isMemoryConnectorId,
|
|
GITHUB_CONNECTOR_PROFILES,
|
|
GOOGLE_WORKSPACE_CONNECTOR_PROFILES,
|
|
isAgentStatusAssignableToWork,
|
|
isGitHubConnectorProfileId,
|
|
isGoogleWorkspaceConnectorProfileId,
|
|
TOOL_ACTION_REQUEST_STATUSES,
|
|
type DeploymentExposure,
|
|
type DeploymentMode,
|
|
type PermissionKey,
|
|
type ToolConnection,
|
|
type ToolConnectionCreateCapabilities,
|
|
connectToolAppSchema,
|
|
createMachineSignInSchema,
|
|
testMachineSignInSchema,
|
|
rotateMachineSignInSchema,
|
|
type MachineSignInStatus,
|
|
configureRailwaySshSchema,
|
|
createConnectionGrantDelegationSchema,
|
|
createToolStdioCommandTemplateSchema,
|
|
createToolApplicationSchema,
|
|
createToolConnectionSchema,
|
|
createToolPolicySchema,
|
|
createToolProfileBindingForProfileSchema,
|
|
createToolProfileEntryForProfileSchema,
|
|
createToolProfileWithEntriesSchema,
|
|
deleteToolProfileSchema,
|
|
duplicateToolPolicySchema,
|
|
disableToolStdioCommandTemplateSchema,
|
|
duplicateToolProfileSchema,
|
|
finishToolAppSchema,
|
|
finalizeOAuthAccessSchema,
|
|
startToolOAuthSchema,
|
|
reconnectToolAppSchema,
|
|
replaceConnectionGrantMembersSchema,
|
|
reviewToolProfileNewToolsSchema,
|
|
createToolTrustRuleFromActionRequestSchema,
|
|
importMcpJsonSchema,
|
|
putToolConnectionInstallsSchema,
|
|
connectionTokenRequestSchema,
|
|
startConnectionAuthorizationSchema,
|
|
revokeToolTrustRuleSchema,
|
|
reorderToolPoliciesSchema,
|
|
toolPolicyTestRequestSchema,
|
|
toolConnectionTestCallSchema,
|
|
unbindToolProfileBindingSchema,
|
|
updateToolApplicationSchema,
|
|
updateToolConnectionSchema,
|
|
updateToolPolicySchema,
|
|
updateToolProfileEntrySchema,
|
|
updateToolProfileWithEntriesSchema,
|
|
} from "@paperclipai/shared";
|
|
import { filterConnectionManagementRows, filterConnectionManagementPolicies, connectionManagementGuard, requiredConnectionUserAction, connectionRequestActor, connectionRequestContext, connectionRequestUserId } from "./connection-management-authz.js";
|
|
import { assertAgentConnectionInstallAccess, connectionManagementService } from "../services/connection-management.js";
|
|
import { validate } from "../middleware/validate.js";
|
|
import { getActorInfo, assertBoard, assertBoardOrAgent, assertCompanyAccess, assertInstanceAdmin, getAccessibleResource, hasCompanyAccess } from "./authz.js";
|
|
import { badRequest, forbidden, HttpError, notFound, unprocessable } from "../errors.js";
|
|
import { accessService, logActivity, toolAccessPolicyService, toolAccessService, vercelConnectIntegrationStatus } from "../services/index.js";
|
|
import { ToolGatewayHttpError, type ToolGatewayService } from "../services/tool-gateway.js";
|
|
import { authorizationService } from "../services/authorization.js";
|
|
import { mcpAppViewsService } from "../services/mcp-app-views.js";
|
|
import { createConnectionContentDeletion } from "../services/tool-access/connections/content-deletion.js";
|
|
import { getRunLogStore } from "../services/run-log-store.js";
|
|
import { listCompanyProviderToolIcons } from "../services/tool-access/catalog/icons.js";
|
|
import { mcpAppToolCallSchema } from "@paperclipai/shared";
|
|
import { RailwayError } from "../services/railway.js";
|
|
import type { VercelConnectClient } from "../services/vercel-connect.js";
|
|
import {
|
|
appWithPaperclipCloudConnectorAvailability,
|
|
isPaperclipCloudConnectorStrategy,
|
|
invalidatePaperclipCloudConnectorCapabilities,
|
|
type PaperclipCloudConnector,
|
|
paperclipCloudConnectorCapabilitiesFromEnv,
|
|
} from "../services/paperclip-cloud-connector.js";
|
|
import { runtimeCanonicalOrigin } from "../services/cloud-runtime-identity.js";
|
|
import { instanceSettingsService } from "../services/instance-settings.js";
|
|
import {
|
|
completePaperclipCloudConnectorEnrollment,
|
|
loadPaperclipCloudConnectorIdentity,
|
|
startPaperclipCloudConnectorEnrollment,
|
|
} from "../services/paperclip-cloud-connector-enrollment.js";
|
|
import { reconcilePaperclipCloudConnectorEnrollmentStatus } from "../services/paperclip-cloud-connector-status.js";
|
|
import { paperclipCloudEnrollmentPrincipal } from "../services/paperclip-cloud-connector-principal.js";
|
|
import {
|
|
OAUTH_CLIENT_ID_METADATA_DOCUMENT_PATH,
|
|
oauthClientIdMetadataDocument,
|
|
} from "../services/tool-access.js";
|
|
import { isLoopbackHost } from "../url-utils.js";
|
|
import { trustedBoardMutationOrigin } from "../middleware/board-mutation-guard.js";
|
|
import { connectionIntentService } from "../services/connection-intents.js";
|
|
import { redactRemoteUrlCredential } from "../services/remote-url-credentials.js";
|
|
import { connectionIntentDeliveryService } from "../services/connection-intent-delivery.js";
|
|
import type { heartbeatService } from "../services/heartbeat.js";
|
|
|
|
const COMPANY_INSTALL_DENIAL_REASON =
|
|
"Only someone who can configure this connection can choose this.";
|
|
const ORGANIZATION_GRANT_DENIAL_REASON =
|
|
"Only a company owner, administrator, or connection manager can share this credential with the organization.";
|
|
type Heartbeat = ReturnType<typeof heartbeatService>;
|
|
|
|
/** Allowlist (e.g. Google Sheets allowed spreadsheet ids) lives in connection config. */
|
|
function asRecord(value: unknown): Record<string, unknown> {
|
|
return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : {};
|
|
}
|
|
|
|
/** Activity for machine sign-in carries identifiers only: never a secret, key or token. */
|
|
function machineSignInActivityDetails(status: MachineSignInStatus) {
|
|
return {
|
|
method: status.method,
|
|
issuer: status.issuer,
|
|
keyId: status.publicKey?.keyId ?? null,
|
|
pendingKeyId: status.pendingPublicKey?.keyId ?? null,
|
|
scopeCount: status.scopes.length,
|
|
};
|
|
}
|
|
|
|
function allowlistIds(config: Record<string, unknown> | null | undefined): string[] {
|
|
const raw = config?.allowedSpreadsheetIds;
|
|
if (!Array.isArray(raw)) return [];
|
|
return raw.filter((value): value is string => typeof value === "string" && value.trim().length > 0);
|
|
}
|
|
|
|
function agentOrgDepths(rows: Array<{ id: string; reportsTo: string | null }>): Map<string, number> {
|
|
const parentById = new Map(rows.map((row) => [row.id, row.reportsTo]));
|
|
const depthById = new Map<string, number>();
|
|
|
|
const depthFor = (agentId: string, path: Set<string>): number => {
|
|
const known = depthById.get(agentId);
|
|
if (known !== undefined) return known;
|
|
const parentId = parentById.get(agentId);
|
|
if (!parentId || !parentById.has(parentId) || path.has(agentId)) {
|
|
depthById.set(agentId, 0);
|
|
return 0;
|
|
}
|
|
const nextPath = new Set(path).add(agentId);
|
|
const depth = depthFor(parentId, nextPath) + 1;
|
|
depthById.set(agentId, depth);
|
|
return depth;
|
|
};
|
|
|
|
for (const row of rows) depthFor(row.id, new Set());
|
|
return depthById;
|
|
}
|
|
|
|
/**
|
|
* Classify a connection PATCH into operator-visible lifecycle events so the
|
|
* per-app Activity tab can humanize them (PAP-11284). A single update may
|
|
* touch more than one thing (e.g. pause + allowlist), so this returns a list.
|
|
*/
|
|
function classifyConnectionUpdate(
|
|
before: { enabled: boolean; config?: Record<string, unknown> | null },
|
|
after: { enabled: boolean; config?: Record<string, unknown> | null },
|
|
): Array<{ lifecycle: "paused" | "resumed" | "allowlist_changed"; details: Record<string, unknown> }> {
|
|
const events: Array<{ lifecycle: "paused" | "resumed" | "allowlist_changed"; details: Record<string, unknown> }> = [];
|
|
if (before.enabled !== after.enabled) {
|
|
events.push({ lifecycle: after.enabled ? "resumed" : "paused", details: { enabled: after.enabled } });
|
|
}
|
|
const beforeIds = allowlistIds(before.config);
|
|
const afterIds = allowlistIds(after.config);
|
|
const beforeSet = new Set(beforeIds);
|
|
const afterSet = new Set(afterIds);
|
|
const added = afterIds.filter((id) => !beforeSet.has(id)).length;
|
|
const removed = beforeIds.filter((id) => !afterSet.has(id)).length;
|
|
if (added > 0 || removed > 0) {
|
|
events.push({ lifecycle: "allowlist_changed", details: { added, removed, total: afterIds.length } });
|
|
}
|
|
return events;
|
|
}
|
|
|
|
export function filterVisibleToolConnections<T extends {
|
|
status?: string;
|
|
createdByUserId?: string | null;
|
|
}>(
|
|
connections: T[],
|
|
actor: { userId?: string | null; canManageConnections: boolean },
|
|
): T[] {
|
|
return connections.filter((connection) =>
|
|
connection.status !== "draft"
|
|
|| actor.canManageConnections
|
|
|| Boolean(actor.userId && connection.createdByUserId === actor.userId));
|
|
}
|
|
|
|
const OAUTH_FAILURE_CODE_PATTERN = /^[a-z][a-z0-9_]{0,63}$/;
|
|
|
|
function githubRecoveryLink(value: unknown): string | null {
|
|
if (typeof value !== "string") return null;
|
|
try {
|
|
const url = new URL(value);
|
|
return url.protocol === "https:" && url.hostname.toLowerCase() === "github.com" && !url.username && !url.password
|
|
? url.toString()
|
|
: null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
export function githubInstallationRecovery(code: string | null | undefined, details: Record<string, unknown> | null) {
|
|
if (code !== "github_installation_required" || !details) return null;
|
|
const installationUrl = githubRecoveryLink(details.installationUrl);
|
|
const managementUrl = githubRecoveryLink(details.managementUrl);
|
|
return installationUrl || managementUrl ? { installationUrl, managementUrl } : null;
|
|
}
|
|
|
|
export function connectionIntentOAuthOutcomeHtml(input: {
|
|
interactionId: string | null;
|
|
issueId: string | null;
|
|
outcome: "connected" | "declined" | "failed";
|
|
openerOrigin?: string | null;
|
|
code?: string | null;
|
|
recovery?: { installationUrl: string | null; managementUrl: string | null } | null;
|
|
}) {
|
|
// The callback window is only a signal. Connection identity and every
|
|
// authorization URL stay server-side; the opener refreshes the task from the
|
|
// interaction id instead of trusting provider-window data.
|
|
const message = JSON.stringify({
|
|
type: "paperclip.connection-intent.oauth",
|
|
...(input.interactionId ? { interactionId: input.interactionId } : {}),
|
|
outcome: input.outcome,
|
|
...(input.outcome === "failed" && input.code && OAUTH_FAILURE_CODE_PATTERN.test(input.code)
|
|
? { code: input.code }
|
|
: {}),
|
|
...(input.outcome === "failed" && input.code === "github_installation_required" && input.recovery
|
|
? { recovery: input.recovery }
|
|
: {}),
|
|
}).replace(/</g, "\\u003c");
|
|
const issuePath = input.issueId
|
|
? `/issues/${encodeURIComponent(input.issueId)}`
|
|
: "/issues";
|
|
const fallback = JSON.stringify(issuePath);
|
|
const openerOrigin = (() => {
|
|
if (!input.openerOrigin) return null;
|
|
try {
|
|
const parsed = new URL(input.openerOrigin);
|
|
return (parsed.protocol === "http:" || parsed.protocol === "https:") && !parsed.username && !parsed.password
|
|
? parsed.origin
|
|
: null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
})();
|
|
const targetOrigin = JSON.stringify(openerOrigin ?? "");
|
|
return `<!doctype html><html><head><meta charset="utf-8"><title>Connection authorization</title></head><body><p>Returning to Paperclip…</p><script>const message=${message};const targetOrigin=${targetOrigin}||window.location.origin;if(window.opener&&window.opener!==window){window.opener.postMessage(message,targetOrigin);window.close();}else{window.location.replace(${fallback});}</script></body></html>`;
|
|
}
|
|
|
|
function normalizeCloudConnectorEnrollmentReturnTo(returnTo?: string | null): string | null {
|
|
if (!returnTo || returnTo.length > 2_048) return null;
|
|
try {
|
|
const parsed = new URL(returnTo, "http://paperclip.local");
|
|
if (
|
|
parsed.origin !== "http://paperclip.local"
|
|
|| !["/apps/connect", "/apps/chat/connect", "/apps/tailscale"].includes(parsed.pathname)
|
|
|| parsed.username
|
|
|| parsed.password
|
|
) return null;
|
|
return `${parsed.pathname}${parsed.search}`;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
export function cloudConnectorEnrollmentOutcomeHtml(issuePrefix: string, returnTo: string, issueId?: string): string {
|
|
const fallbackPath = issueId
|
|
? `/${encodeURIComponent(issuePrefix)}/issues/${encodeURIComponent(issueId)}`
|
|
: cloudConnectorEnrollmentReturnPath(issuePrefix, returnTo);
|
|
const fallback = JSON.stringify(fallbackPath).replaceAll("<", "\\u003c");
|
|
// This document is served only after server-verified enrollment. The parent
|
|
// independently re-reads enrollment status; browser messages grant no access.
|
|
return `<!doctype html><html><head><meta charset="utf-8"><title>Paperclip connected</title></head><body><p>Paperclip is connected. Return to your task to finish connecting the app.</p><script>if(window.opener&&window.opener!==window){window.close();}else{const link=document.createElement("a");link.href=${fallback};link.textContent=${JSON.stringify(issueId ? "Return to task" : "Continue setup")};document.body.append(link);}</script></body></html>`;
|
|
}
|
|
|
|
export function cloudConnectorEnrollmentReturnPath(issuePrefix: string, returnTo?: string | null): string {
|
|
const companyRoot = `/${encodeURIComponent(issuePrefix)}`;
|
|
const normalizedReturnTo = normalizeCloudConnectorEnrollmentReturnTo(returnTo);
|
|
if (normalizedReturnTo) {
|
|
const parsed = new URL(normalizedReturnTo, "http://paperclip.local");
|
|
parsed.searchParams.set("cloud_connector", "enrolled");
|
|
return `${companyRoot}${parsed.pathname}${parsed.search}`;
|
|
}
|
|
return `${companyRoot}/apps/connections?cloud_connector=enrolled`;
|
|
}
|
|
|
|
const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
|
|
export function toolAccessRoutes(
|
|
db: Db,
|
|
options: {
|
|
deploymentMode?: DeploymentMode;
|
|
deploymentExposure?: DeploymentExposure;
|
|
authPublicBaseUrl?: string | null;
|
|
trustedLocalStdioRuntimeHost?: string | null;
|
|
toolGateway?: ToolGatewayService;
|
|
/** Test-only seams forwarded to the tool access service. */
|
|
remoteHttpEndpointLookup?: NonNullable<Parameters<typeof toolAccessService>[1]>["remoteHttpEndpointLookup"];
|
|
remoteHttpRequest?: NonNullable<Parameters<typeof toolAccessService>[1]>["remoteHttpRequest"];
|
|
vercelConnectClient?: VercelConnectClient | null;
|
|
paperclipCloudConnector?: PaperclipCloudConnector | null;
|
|
connectionIntentHeartbeat?: Pick<Heartbeat, "wakeup">;
|
|
} = {},
|
|
) {
|
|
const router = Router();
|
|
const svc = toolAccessService(db, options);
|
|
const policySvc = toolAccessPolicyService(db);
|
|
const connectionIntents = connectionIntentService(db);
|
|
|
|
async function isConnectionIntent(interactionId: string | null | undefined) {
|
|
if (!interactionId) return false;
|
|
const row = await db
|
|
.select({ kind: issueThreadInteractions.kind })
|
|
.from(issueThreadInteractions)
|
|
.where(eq(issueThreadInteractions.id, interactionId))
|
|
.limit(1)
|
|
.then((rows) => rows[0] ?? null);
|
|
return row?.kind === "connection_intent";
|
|
}
|
|
|
|
function bypassCurrentMembershipCheck(req: Request) {
|
|
return req.actor.source === "local_implicit" || req.actor.isInstanceAdmin === true;
|
|
}
|
|
|
|
async function finishConnectionIntentOAuth(input: {
|
|
interactionId: string;
|
|
connectionId?: string;
|
|
userId: string;
|
|
outcome: "connected" | "declined" | "failed";
|
|
canManageOrganizationGrant: boolean;
|
|
bypassCurrentMembershipCheck: boolean;
|
|
}) {
|
|
const loaded = await connectionIntents.loadIntent(input.interactionId);
|
|
if (loaded.interaction.addresseeUserId !== input.userId) {
|
|
throw forbidden("OAuth callback user does not match the connection request");
|
|
}
|
|
if (loaded.interaction.status !== "pending") return loaded.interaction;
|
|
const interaction = input.outcome === "connected" && input.connectionId
|
|
? await connectionIntents.complete(input.interactionId, input.connectionId, input.userId, {
|
|
oauthCompletion: true,
|
|
canManageOrganizationGrant: input.canManageOrganizationGrant,
|
|
bypassCurrentMembershipCheck: input.bypassCurrentMembershipCheck,
|
|
})
|
|
: await connectionIntents.updatePhase(input.interactionId, "needs_retry", input.userId, {
|
|
bypassCurrentMembershipCheck: input.bypassCurrentMembershipCheck,
|
|
});
|
|
if (interaction.status === "accepted" && options.connectionIntentHeartbeat) {
|
|
await connectionIntentDeliveryService(db, options.connectionIntentHeartbeat).tryDeliver(input.interactionId);
|
|
}
|
|
return interaction;
|
|
}
|
|
|
|
function sendConnectionIntentOAuthOutcome(
|
|
res: import("express").Response,
|
|
input: {
|
|
interactionId: string;
|
|
issueId: string | null;
|
|
outcome: "connected" | "declined" | "failed";
|
|
openerOrigin?: string | null;
|
|
code?: string | null;
|
|
recovery?: { installationUrl: string | null; managementUrl: string | null } | null;
|
|
},
|
|
) {
|
|
res.type("html").send(connectionIntentOAuthOutcomeHtml(input));
|
|
}
|
|
|
|
function configuredPublicBaseUrl() {
|
|
const runtimeOrigin = runtimeCanonicalOrigin();
|
|
if (runtimeOrigin) return runtimeOrigin;
|
|
const raw = (
|
|
process.env.PAPERCLIP_AUTH_PUBLIC_BASE_URL?.trim()
|
|
|| process.env.BETTER_AUTH_URL?.trim()
|
|
|| process.env.BETTER_AUTH_BASE_URL?.trim()
|
|
|| options.authPublicBaseUrl?.trim()
|
|
|| process.env.PAPERCLIP_PUBLIC_URL?.trim()
|
|
|| process.env.PAPERCLIP_MANAGED_RUNTIME_PUBLIC_URL?.trim()
|
|
);
|
|
if (!raw) return null;
|
|
try {
|
|
return new URL(raw).origin;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
function requestLoopbackBaseUrl(req: Request, forInitiation = false) {
|
|
const host = req.get("host")?.trim();
|
|
if (!host) return null;
|
|
try {
|
|
const parsed = new URL(`${req.protocol}://${host}`);
|
|
if (
|
|
(parsed.protocol !== "http:" && parsed.protocol !== "https:")
|
|
|| parsed.username
|
|
|| parsed.password
|
|
|| !isLoopbackHost(parsed.hostname)
|
|
) {
|
|
return null;
|
|
}
|
|
// A few otherwise standards-compliant DCR servers reject numeric
|
|
// loopback redirect hosts while accepting localhost. In local-trusted
|
|
// mode both names reach the same loopback-only process, so advertise the
|
|
// interoperable spelling and retain the browser's exact origin as OAuth
|
|
// state for popup postMessage below.
|
|
if (
|
|
(forInitiation || (req.method !== "GET" && req.method !== "HEAD"))
|
|
&& (options.deploymentMode ?? "local_trusted") === "local_trusted"
|
|
&& parsed.protocol === "http:"
|
|
&& parsed.hostname !== "localhost"
|
|
) {
|
|
parsed.hostname = "localhost";
|
|
}
|
|
// A provider callback has no initiating browser Origin. Preserve its
|
|
// actual host: rewriting 127.0.0.1 here changes the redirect_uri used at
|
|
// authorization and causes the token endpoint to reject the code.
|
|
return parsed.origin;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
function trustedBrowserBaseUrl(req: Request) {
|
|
const origin = trustedBoardMutationOrigin(req);
|
|
if (!origin) return null;
|
|
try {
|
|
const parsed = new URL(origin);
|
|
const forwardedHost = req.header("x-forwarded-host")?.split(",")[0]?.trim();
|
|
const routedHost = forwardedHost || req.header("host")?.trim();
|
|
const normalizedRoutedHost = routedHost
|
|
? new URL(`${parsed.protocol}//${routedHost}`).host.toLowerCase()
|
|
: null;
|
|
if (
|
|
parsed.host.toLowerCase() === normalizedRoutedHost
|
|
&& parsed.protocol === "https:"
|
|
) {
|
|
return parsed.origin;
|
|
}
|
|
} catch {
|
|
// The shared origin parser already validates this. Fail closed if its
|
|
// contract ever changes.
|
|
}
|
|
return null;
|
|
}
|
|
|
|
function enrolledConnectorBaseUrl(req: Request) {
|
|
// Browser-initiated mutations must prove their own same-origin HTTPS
|
|
// request. The durable binding is only a callback/metadata fallback for
|
|
// provider GETs, which do not carry the initiating browser's Origin.
|
|
if (req.method !== "GET" && req.method !== "HEAD") return null;
|
|
const identity = loadPaperclipCloudConnectorIdentity();
|
|
if (identity?.status !== "active") return null;
|
|
const forwardedHost = req.header("x-forwarded-host")?.split(",")[0]?.trim();
|
|
const requestHost = (forwardedHost || req.header("host")?.trim())?.toLowerCase();
|
|
if (!requestHost) return null;
|
|
for (const origin of identity.origins) {
|
|
try {
|
|
const parsed = new URL(origin);
|
|
if (
|
|
parsed.protocol === "https:"
|
|
&& !parsed.username
|
|
&& !parsed.password
|
|
&& parsed.host.toLowerCase() === requestHost
|
|
) {
|
|
return parsed.origin;
|
|
}
|
|
} catch {
|
|
// Ignore malformed legacy identity origins.
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
// Agents already have this instance's tools built in. Connecting it to itself
|
|
// only adds a second copy under another name, which is the confusion the
|
|
// peer-connection naming exists to prevent.
|
|
function assertNotThisPaperclip(req: Request, link: unknown) {
|
|
const peer = typeof link === "string" ? paperclipPeerFromMcpUrl(link) : null;
|
|
if (!peer) return;
|
|
const requestHost = req.get("host")?.trim();
|
|
const ownOrigins = [
|
|
configuredPublicBaseUrl(),
|
|
options.authPublicBaseUrl,
|
|
process.env.PAPERCLIP_PUBLIC_URL,
|
|
trustedBrowserBaseUrl(req),
|
|
requestLoopbackBaseUrl(req),
|
|
requestHost ? `${req.protocol}://${requestHost}` : null,
|
|
// The port this server actually listens on; startup may move off PORT.
|
|
process.env.PAPERCLIP_LISTEN_PORT ? `http://localhost:${process.env.PAPERCLIP_LISTEN_PORT}` : null,
|
|
];
|
|
if (isSamePaperclipInstance(peer, ownOrigins)) {
|
|
throw unprocessable(
|
|
"That address is this Paperclip. Your agents already have its tools, so there is nothing to connect.",
|
|
{ code: "paperclip_self_connection" },
|
|
);
|
|
}
|
|
}
|
|
|
|
function oauthRedirectUri(req: Request, forInitiation = false) {
|
|
const baseUrl = configuredPublicBaseUrl()
|
|
?? trustedBrowserBaseUrl(req)
|
|
?? enrolledConnectorBaseUrl(req)
|
|
?? requestLoopbackBaseUrl(req, forInitiation);
|
|
if (!baseUrl) {
|
|
throw unprocessable(
|
|
"This Paperclip needs a browser-reachable HTTPS address (or loopback HTTP) before browser sign-in can start.",
|
|
{ code: "oauth_redirect_origin_unsupported" },
|
|
);
|
|
}
|
|
return new URL("/api/tools/oauth/callback", baseUrl).toString();
|
|
}
|
|
|
|
function oauthBrowserOrigin(req: Request) {
|
|
const trustedBrowserOrigin = trustedBrowserBaseUrl(req);
|
|
if (trustedBrowserOrigin) return trustedBrowserOrigin;
|
|
const host = req.get("host")?.trim();
|
|
if (!host) return null;
|
|
try {
|
|
const parsed = new URL(`${req.protocol}://${host}`);
|
|
return isLoopbackHost(parsed.hostname) ? parsed.origin : null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
async function oauthAppPath(
|
|
companyId: string,
|
|
connectionId: string,
|
|
) {
|
|
const [company] = await db
|
|
.select({ issuePrefix: companies.issuePrefix })
|
|
.from(companies)
|
|
.where(eq(companies.id, companyId))
|
|
.limit(1);
|
|
if (!company) throw new Error("OAuth callback connection belongs to a missing company");
|
|
return `/${company.issuePrefix}/apps/${connectionId}/permissions`;
|
|
}
|
|
|
|
function connectorEnrollmentPrincipal(req: Request): string {
|
|
return paperclipCloudEnrollmentPrincipal(req.actor);
|
|
}
|
|
|
|
/**
|
|
* A failed first authorization is still an incomplete setup, not an app
|
|
* configuration task. Send it back to the same exact draft so the operator
|
|
* can retry the missing checkpoint. Reauthorization of an already-active
|
|
* connection keeps the established detail-page recovery route.
|
|
*/
|
|
async function oauthRecoveryPath(
|
|
connection: ToolConnection,
|
|
outcome: "failed" | "denied",
|
|
code?: string | null,
|
|
providerRecovery?: { installationUrl?: unknown; managementUrl?: unknown },
|
|
) {
|
|
const detailPermissionsPath = await oauthAppPath(connection.companyId, connection.id);
|
|
const params = new URLSearchParams({ oauth: outcome });
|
|
if (code) params.set("code", code);
|
|
const addGitHubRecoveryUrls = (target: URLSearchParams) => {
|
|
if (code !== "github_installation_required") return;
|
|
for (const [key, value] of [
|
|
["installation_url", providerRecovery?.installationUrl],
|
|
["management_url", providerRecovery?.managementUrl],
|
|
] as const) {
|
|
if (typeof value !== "string") continue;
|
|
try {
|
|
const url = new URL(value);
|
|
if (url.protocol === "https:" && url.hostname.toLowerCase() === "github.com") {
|
|
target.set(key, url.toString());
|
|
}
|
|
} catch {
|
|
// Provider recovery links are optional. The retry path remains usable
|
|
// when an upstream response omits or malforms one.
|
|
}
|
|
}
|
|
};
|
|
addGitHubRecoveryUrls(params);
|
|
const source = connection.config?.sourceTemplateKey
|
|
?? connection.transportConfig?.sourceTemplateKey;
|
|
if (connection.status !== "draft" || typeof source !== "string" || !source.trim()) {
|
|
return `${detailPermissionsPath}?${params.toString()}`;
|
|
}
|
|
|
|
const appsSegment = detailPermissionsPath.indexOf("/apps/");
|
|
const companyPrefix = appsSegment >= 0 ? detailPermissionsPath.slice(0, appsSegment) : "";
|
|
const setupParams = new URLSearchParams({
|
|
source,
|
|
resume: connection.id,
|
|
oauth: outcome,
|
|
});
|
|
if (code) setupParams.set("code", code);
|
|
addGitHubRecoveryUrls(setupParams);
|
|
const setupRoute = connection.credentialSource === "vercel_connect"
|
|
? "/apps/vercel-connect"
|
|
: "/apps/connect";
|
|
return `${companyPrefix}${setupRoute}?${setupParams.toString()}`;
|
|
}
|
|
|
|
const access = accessService(db);
|
|
const managementGuard = connectionManagementGuard(db, "tool");
|
|
const contentDeletion = createConnectionContentDeletion(db, { runLogStore: getRunLogStore });
|
|
|
|
async function assertBoardToolPermission(req: Request, companyId: string, permissionKey: PermissionKey) {
|
|
if (req.actor.type === "agent") {
|
|
const context = connectionRequestContext(req);
|
|
if (!context || context.resource.companyId !== companyId) throw forbidden("This operation requires an authorized management context");
|
|
await context.reauthorize();
|
|
return;
|
|
}
|
|
assertBoardOrAgent(req);
|
|
assertCompanyAccess(req, companyId);
|
|
if (req.actor.source === "local_implicit" || req.actor.isInstanceAdmin) return;
|
|
const userId = connectionRequestUserId(req);
|
|
if (userId && await access.hasPermission(companyId, "user", userId, permissionKey)) return;
|
|
throw forbidden(`Missing permission: ${permissionKey}`);
|
|
}
|
|
|
|
function activeToolMembership(req: Request, companyId: string) {
|
|
assertBoardOrAgent(req);
|
|
assertCompanyAccess(req, companyId);
|
|
if (req.actor.source === "local_implicit" || req.actor.isInstanceAdmin) return null;
|
|
const membership = Array.isArray((req.actor.type === "agent" ? req.actor.onBehalfOfMemberships : req.actor.memberships))
|
|
? (req.actor.type === "agent" ? req.actor.onBehalfOfMemberships : req.actor.memberships)?.find((item) => item.companyId === companyId)
|
|
: null;
|
|
if (!membership || membership.status !== "active") {
|
|
throw forbidden("User does not have active company access");
|
|
}
|
|
if (!membership.membershipRole || membership.membershipRole === "viewer") {
|
|
throw forbidden("Viewer access is read-only");
|
|
}
|
|
return membership;
|
|
}
|
|
|
|
async function isToolConnectionManager(req: Request, companyId: string) {
|
|
assertBoardOrAgent(req);
|
|
assertCompanyAccess(req, companyId);
|
|
if (req.actor.source === "local_implicit" || req.actor.isInstanceAdmin) return true;
|
|
return Boolean(connectionRequestUserId(req) && await access.hasPermission(
|
|
companyId,
|
|
"user",
|
|
connectionRequestUserId(req)!,
|
|
"tools:manage_connections",
|
|
));
|
|
}
|
|
|
|
async function assertToolConnectionConfigureAccess(
|
|
req: Request,
|
|
connection: { companyId: string; createdByUserId?: string | null },
|
|
) {
|
|
activeToolMembership(req, connection.companyId);
|
|
if (await isToolConnectionManager(req, connection.companyId)) return;
|
|
if (connectionRequestUserId(req) && connection.createdByUserId === connectionRequestUserId(req)) return;
|
|
throw forbidden(
|
|
"Only the connection creator or a connection manager can configure, reconnect, or delete this connection",
|
|
);
|
|
}
|
|
|
|
async function assertToolConnectionAccess(
|
|
req: Request,
|
|
connection: { id: string; companyId: string; createdByUserId?: string | null },
|
|
) {
|
|
activeToolMembership(req, connection.companyId);
|
|
if (await isToolConnectionManager(req, connection.companyId)) return;
|
|
if (connectionRequestUserId(req) && connection.createdByUserId === connectionRequestUserId(req)) return;
|
|
const [grant] = await db
|
|
.select({ id: connectionGrants.id })
|
|
.from(connectionGrants)
|
|
.where(and(
|
|
eq(connectionGrants.companyId, connection.companyId),
|
|
eq(connectionGrants.connectionId, connection.id),
|
|
eq(connectionGrants.status, "active"),
|
|
or(
|
|
eq(connectionGrants.kind, "organization"),
|
|
connectionRequestUserId(req)
|
|
? and(eq(connectionGrants.kind, "user"), eq(connectionGrants.subjectUserId, connectionRequestUserId(req)!))
|
|
: eq(connectionGrants.kind, "organization"),
|
|
),
|
|
))
|
|
.limit(1);
|
|
if (grant) return;
|
|
throw forbidden("You need access to this connection before you can install it on an agent");
|
|
}
|
|
|
|
/**
|
|
* Non-throwing membership probe for capability reporting (PAP-17835).
|
|
*
|
|
* `activeToolMembership` throws for viewers because it guards mutations. The
|
|
* personal-connections UI still has to *render* for a viewer, so capability
|
|
* computation needs the role without the 403. Returns `null` for a principal
|
|
* with no scoped membership (local implicit / instance admin), matching
|
|
* `activeToolMembership`'s "unrestricted" sentinel.
|
|
*/
|
|
function toolMembershipRole(req: Request, companyId: string): {
|
|
unrestricted: boolean;
|
|
role: string | null;
|
|
isViewer: boolean;
|
|
isActive: boolean;
|
|
} {
|
|
if (req.actor.source === "local_implicit" || req.actor.isInstanceAdmin) {
|
|
return { unrestricted: true, role: null, isViewer: false, isActive: true };
|
|
}
|
|
const membership = Array.isArray((req.actor.type === "agent" ? req.actor.onBehalfOfMemberships : req.actor.memberships))
|
|
? (req.actor.type === "agent" ? req.actor.onBehalfOfMemberships : req.actor.memberships)?.find((item) => item.companyId === companyId)
|
|
: null;
|
|
const isActive = Boolean(membership && membership.status === "active");
|
|
const role = membership?.membershipRole ?? null;
|
|
return { unrestricted: false, role, isViewer: role === "viewer", isActive };
|
|
}
|
|
|
|
async function isToolConnectionManagerQuiet(req: Request, companyId: string) {
|
|
if (req.actor.type === "agent") return (await connectionManagementService(db).capability(req.actor, "connections:configure", {
|
|
...connectionRequestContext(req)?.resource, type: "connection_management", companyId,
|
|
connectionId: undefined, selfServiceUserId: undefined, readOnly: false,
|
|
operation: connectionRequestContext(req)?.resource.operation ?? "configure",
|
|
}, { readContext: connectionRequestContext(req) })).allowed;
|
|
const membership = toolMembershipRole(req, companyId);
|
|
if (membership.unrestricted) return true;
|
|
if (!membership.isActive || membership.isViewer) return false;
|
|
if (membership.role === "owner" || membership.role === "admin") return true;
|
|
return Boolean(connectionRequestUserId(req) && await access.hasPermission(
|
|
companyId,
|
|
"user",
|
|
connectionRequestUserId(req)!,
|
|
"tools:manage_connections",
|
|
));
|
|
}
|
|
|
|
async function describeConnectionCreateCapabilities(
|
|
req: Request,
|
|
companyId: string,
|
|
): Promise<ToolConnectionCreateCapabilities> {
|
|
const canManageConnections = await isToolConnectionManagerQuiet(req, companyId);
|
|
return {
|
|
canCreateOrganizationGrant: canManageConnections,
|
|
organizationGrantReason: canManageConnections ? null : ORGANIZATION_GRANT_DENIAL_REASON,
|
|
canSetCompanyInstall: canManageConnections,
|
|
companyInstallReason: canManageConnections ? null : COMPANY_INSTALL_DENIAL_REASON,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Server-computed capabilities for the connection identity/install surfaces.
|
|
* The UI renders the §3 matrix from these booleans instead of reconstructing
|
|
* policy from role strings, because creator identity and per-agent edit rights
|
|
* are not derivable client-side.
|
|
*/
|
|
async function describeConnectionCapabilities(
|
|
req: Request,
|
|
connection: { id: string; companyId: string; createdByUserId?: string | null },
|
|
) {
|
|
const membership = toolMembershipRole(req, connection.companyId);
|
|
const isManager = await isToolConnectionManagerQuiet(req, connection.companyId);
|
|
const mutationCapable = membership.unrestricted || (membership.isActive && !membership.isViewer);
|
|
const isCreator = Boolean(connectionRequestUserId(req) && connection.createdByUserId === connectionRequestUserId(req));
|
|
const management = connectionManagementService(db);
|
|
const resource = { ...connectionRequestContext(req)?.resource, type: "connection_management" as const,
|
|
companyId: connection.companyId, connectionId: connection.id, operation: "configure",
|
|
readOnly: false, selfServiceUserId: connection.createdByUserId };
|
|
const manage = await management.capability(req.actor, "connections:configure", resource, { readContext: connectionRequestContext(req) });
|
|
const use = await management.capability(req.actor, "connections:test", { ...resource, operation: "use" }, { mutation: false, readContext: connectionRequestContext(req) });
|
|
const toolAccess = req.actor.type === "agent" && req.actor.agentId && options.toolGateway
|
|
? await options.toolGateway.summarizeConnectionAccessForAgent({ companyId: connection.companyId, connectionId: connection.id,
|
|
agentId: req.actor.agentId, heartbeatRunId: req.actor.runId, issueId: resource.issueId, projectId: resource.projectId }) : null;
|
|
const usage = toolAccess ? { ...use, allowed: use.allowed && toolAccess.allowedCount > 0,
|
|
reason: !use.allowed ? use.reason : toolAccess.allowedCount > 0 ? "Configured actions are allowed; each call reauthorizes."
|
|
: toolAccess.askFirstCount > 0 ? "Configured actions require approval." : "No configured actions are available.",
|
|
requiresApproval: toolAccess.askFirstCount > 0, allowedCount: toolAccess.allowedCount, askFirstCount: toolAccess.askFirstCount } : use;
|
|
const canConfigure = manage.allowed;
|
|
const editableAgentIds: string[] = [];
|
|
if (mutationCapable) {
|
|
const companyAgents = await db.select({ id: agents.id }).from(agents).where(eq(agents.companyId, connection.companyId));
|
|
const capabilities = await management.describeAgentInstallCapabilities(req.actor, resource, companyAgents.map(agent => agent.id), { readContext: connectionRequestContext(req) });
|
|
for (let i = 0; i < companyAgents.length; i++) {
|
|
if (capabilities[i].allowed) editableAgentIds.push(companyAgents[i].id);
|
|
}
|
|
}
|
|
return {
|
|
canConfigure,
|
|
management: manage,
|
|
usage,
|
|
canCreateOrganizationGrant: canConfigure,
|
|
canSetCompanyInstall: canConfigure,
|
|
// Personal consent belongs to the person: it needs a named board user, and
|
|
// it is never available to a viewer or to an unauthenticated principal.
|
|
canConnectAsCurrentUser: Boolean(connectionRequestUserId(req)) && mutationCapable,
|
|
canManageAgentInstalls: mutationCapable && editableAgentIds.length > 0,
|
|
canViewOtherPersonalIdentities: req.actor.type === "board" && isManager,
|
|
editableAgentIds,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Per-grant authorization. Revoking your own identity is always allowed (the
|
|
* consent is yours to withdraw); revoking anyone else's is manager-only — that
|
|
* is the kill switch. Audience editing is creator-or-manager, and only for an
|
|
* organization grant.
|
|
*/
|
|
function describeGrantCapabilities(
|
|
grant: { kind: string; subjectUserId: string | null; createdByUserId: string | null },
|
|
context: { userId: string | null; isManager: boolean; mutationCapable: boolean },
|
|
) {
|
|
if (!context.mutationCapable) return { canRevoke: false, canEditAudience: false };
|
|
const isOwnGrant = Boolean(context.userId && grant.subjectUserId === context.userId);
|
|
const isGrantCreator = Boolean(context.userId && grant.createdByUserId === context.userId);
|
|
return {
|
|
canRevoke: isOwnGrant || isGrantCreator || context.isManager,
|
|
canEditAudience: grant.kind === "organization" && (isGrantCreator || context.isManager),
|
|
};
|
|
}
|
|
|
|
async function assertBoardAnyToolPermission(req: Request, companyId: string, permissionKeys: PermissionKey[]) {
|
|
assertBoardOrAgent(req);
|
|
assertCompanyAccess(req, companyId);
|
|
if (req.actor.source === "local_implicit" || req.actor.isInstanceAdmin) return;
|
|
const userId = connectionRequestUserId(req);
|
|
if (userId) {
|
|
for (const permissionKey of permissionKeys) {
|
|
if (await access.hasPermission(companyId, "user", userId, permissionKey)) return;
|
|
}
|
|
}
|
|
throw forbidden(`Missing one of permissions: ${permissionKeys.join(", ")}`);
|
|
}
|
|
|
|
async function assertCanTestAsAgent(req: Request, companyId: string, agentId: string, knownAgent?: { id: string; status: string }) {
|
|
const agent = knownAgent ?? (await db
|
|
.select({ id: agents.id, status: agents.status })
|
|
.from(agents)
|
|
.where(and(eq(agents.id, agentId), eq(agents.companyId, companyId)))
|
|
.limit(1))[0];
|
|
// Admin permission bypasses must not make unassignable agents testable.
|
|
if (!agent || agent.id !== agentId || !isAgentStatusAssignableToWork(agent.status)) {
|
|
throw forbidden("This agent is not available for testing");
|
|
}
|
|
const decision = await access.decide({
|
|
actor: req.actor,
|
|
action: "tasks:assign",
|
|
resource: {
|
|
type: "issue",
|
|
companyId,
|
|
issueId: null,
|
|
projectId: null,
|
|
parentIssueId: null,
|
|
assigneeAgentId: agentId,
|
|
assigneeUserId: null,
|
|
},
|
|
scope: {
|
|
assigneeAgentId: agentId,
|
|
assigneeUserId: null,
|
|
},
|
|
});
|
|
if (decision.allowed) return;
|
|
throw forbidden(decision.explanation);
|
|
}
|
|
|
|
function sendToolGatewayError(res: import("express").Response, error: unknown) {
|
|
if (error instanceof ToolGatewayHttpError) {
|
|
res.status(error.status).json({ error: error.message, reasonCode: error.reasonCode, ...error.details });
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
async function assertToolsAdmin(req: Request, companyId: string) {
|
|
assertBoard(req);
|
|
await assertBoardToolPermission(req, companyId, "tools:admin");
|
|
}
|
|
|
|
async function assertToolsRuntimeManage(req: Request, companyId: string) {
|
|
await assertBoardToolPermission(req, companyId, "tools:manage_runtime");
|
|
}
|
|
|
|
router.post("/agents/me/connections/:connectionId/start-authorization", managementGuard("connections:configure", "POST /agents/me/connections/:connectionId/start-authorization", { personal: true }), validate(startConnectionAuthorizationSchema), async (req, res) => {
|
|
if (req.actor.type !== "agent" || !req.actor.agentId || !req.actor.companyId || !req.actor.runId) {
|
|
res.status(401).json({ error: "Active agent run authentication required" });
|
|
return;
|
|
}
|
|
const result = await svc.startAuthorizationForAgent({
|
|
companyId: req.actor.companyId,
|
|
connectionId: req.params.connectionId as string,
|
|
agentId: req.actor.agentId,
|
|
runId: req.actor.runId,
|
|
subjectUserId: req.body.subjectUserId,
|
|
scopes: req.body.scopes,
|
|
returnTo: req.body.returnTo,
|
|
redirectUri: oauthRedirectUri(req),
|
|
managementContext: connectionRequestContext(req),
|
|
});
|
|
res.json({ ...requiredConnectionUserAction(req, { type: "connection", id: req.params.connectionId as string, companyId: req.actor.companyId }, result.authorizationUrl, "Authenticate the selected account and consent to the requested provider access."), url: result.authorizationUrl, ...(result.handoff ? { handoff: result.handoff } : {}) });
|
|
});
|
|
|
|
router.post("/agents/me/connections/:connectionId/token", validate(connectionTokenRequestSchema), async (req, res) => {
|
|
if (req.actor.type !== "agent" || !req.actor.agentId || !req.actor.companyId) {
|
|
res.status(401).json({ error: "Agent authentication required" });
|
|
return;
|
|
}
|
|
if (!req.actor.runId) {
|
|
res.status(401).json({ error: "Agent run id required", code: "run_id_required" });
|
|
return;
|
|
}
|
|
const headerRunId = req.get("X-Paperclip-Run-Id")?.trim();
|
|
if (headerRunId && headerRunId !== req.actor.runId) {
|
|
res.status(403).json({ error: "Run id header does not match agent token", code: "run_id_mismatch" });
|
|
return;
|
|
}
|
|
const result = await svc.mintConnectionTokenForAgent({
|
|
connectionId: req.params.connectionId as string,
|
|
companyId: req.actor.companyId,
|
|
agentId: req.actor.agentId,
|
|
runId: req.actor.runId,
|
|
body: req.body,
|
|
});
|
|
res.status(result.status === "use_env_lease" ? 409 : 200).json(result);
|
|
});
|
|
|
|
function assertToolAppMutationAccess(req: Request, companyId: string) {
|
|
if (req.actor.type === "agent" && !connectionRequestContext(req)) throw forbidden("An authorized connection management operation is required");
|
|
activeToolMembership(req, companyId);
|
|
}
|
|
|
|
router.get("/companies/:companyId/tools/gallery", managementGuard("connections:read", "GET /companies/:companyId/tools/gallery", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const advertisedProfiles = options.paperclipCloudConnector === undefined
|
|
? await paperclipCloudConnectorCapabilitiesFromEnv()
|
|
: options.paperclipCloudConnector
|
|
? await options.paperclipCloudConnector.getCapabilities()
|
|
: [];
|
|
const vercelConnect = vercelConnectIntegrationStatus();
|
|
const settings = await instanceSettingsService(db).getExperimental();
|
|
let oauthCallbackUrl: string | undefined;
|
|
try {
|
|
// Setup must display the callback used by its initiating POST. Provider
|
|
// callbacks themselves retain their exact request-derived redirect URI.
|
|
oauthCallbackUrl = oauthRedirectUri(req, true);
|
|
} catch (error) {
|
|
const details = error instanceof HttpError
|
|
&& error.details
|
|
&& typeof error.details === "object"
|
|
&& !Array.isArray(error.details)
|
|
? error.details as Record<string, unknown>
|
|
: null;
|
|
if (details?.code !== "oauth_redirect_origin_unsupported") throw error;
|
|
}
|
|
const pluginApps = (await loadPluginAppCatalog(db)).definitions;
|
|
res.json({
|
|
...(oauthCallbackUrl ? { oauthCallbackUrl } : {}),
|
|
// Full definitions of plugin-provided connectors. Like the built-in
|
|
// definitions the board bundles, they keep methods the gallery entry
|
|
// hides until (for example) Cloud connector enrollment is active.
|
|
pluginApps,
|
|
capabilities: await describeConnectionCreateCapabilities(req, companyId),
|
|
credentialSources: {
|
|
vercelConnect: {
|
|
available: vercelConnect.enabled && vercelConnect.configured,
|
|
enabled: vercelConnect.enabled,
|
|
authentication: vercelConnect.authentication,
|
|
manageUrl: vercelConnect.manageUrl,
|
|
reason: vercelConnect.enabled
|
|
? vercelConnect.configured
|
|
? null
|
|
: "Vercel Connect needs workload OIDC or PAPERCLIP_VERCEL_CONNECT_ACCESS_TOKEN."
|
|
: "Vercel Connect setup is disabled on this Paperclip instance.",
|
|
},
|
|
},
|
|
apps: [...APP_STORE_DEFINITIONS.filter((app) => (settings.enableMemoryConnectors || !isMemoryConnectorId(app.slug))
|
|
&& isConnectorFeatureEnabled(app, settings)).map((app) =>
|
|
appWithPaperclipCloudConnectorAvailability(app, advertisedProfiles)
|
|
), ...pluginApps.map((app) =>
|
|
appWithPaperclipCloudConnectorAvailability(app, advertisedProfiles)
|
|
), ...await aiConnectionRouterService(db).catalog()],
|
|
});
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/apps/:galleryKey/preflight", managementGuard("connections:read", "GET /companies/:companyId/tools/apps/:galleryKey/preflight", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const methodKey = typeof req.query.methodKey === "string" ? req.query.methodKey.trim() || null : null;
|
|
res.json(await svc.preflightGalleryAppMetadata(req.params.galleryKey as string, methodKey));
|
|
});
|
|
|
|
/**
|
|
* Paperclip's Client ID Metadata Document (PAP-17087).
|
|
*
|
|
* The document's own URL is the `client_id` Paperclip presents to an
|
|
* authorization server that supports CIMD, so this endpoint has to be publicly
|
|
* readable — an authorization server fetches it server-to-server with no
|
|
* Paperclip session. It contains only this deployment's callback and the
|
|
* grant/response/auth methods Paperclip uses: no company, connection or secret
|
|
* data of any kind.
|
|
*/
|
|
router.get(OAUTH_CLIENT_ID_METADATA_DOCUMENT_PATH.replace(/^\/api/, ""), (_req, res) => {
|
|
const redirectUri = oauthRedirectUri(_req);
|
|
const clientId = new URL(OAUTH_CLIENT_ID_METADATA_DOCUMENT_PATH, new URL(redirectUri).origin).toString();
|
|
res.type("application/json").json(oauthClientIdMetadataDocument({ clientId, redirectUri }));
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/apps/connect", managementGuard("connections:configure", "POST /companies/:companyId/tools/apps/connect", { personal: true }), validate(connectToolAppSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
// An omitted grant kind is the backward-compatible organization default.
|
|
// On resume, the persisted connection identity is authoritative: accepting
|
|
// a contradictory `grantKind: "user"` here could otherwise let a creator
|
|
// replace the credential behind an existing organization grant.
|
|
const retainedConnectionId = req.body.resumeConnectionId ?? req.body.reconnectConnectionId;
|
|
const resumedConnection = retainedConnectionId
|
|
? await svc.getConnection(retainedConnectionId, companyId)
|
|
: null;
|
|
if (resumedConnection) await assertToolConnectionConfigureAccess(req, resumedConnection);
|
|
const effectiveGrantKind = resumedConnection
|
|
? resumedConnection.credentialPolicy === "per_user"
|
|
? "user"
|
|
: resumedConnection.credentialPolicy === "per_agent"
|
|
? "agent"
|
|
: "organization"
|
|
: req.body.grantKind ?? "organization";
|
|
// Personal connection creation remains available to ordinary active
|
|
// members, but sharing a credential with every human is a manager
|
|
// operation and must be enforced here, not inferred by the client.
|
|
const createsManagedGrant = effectiveGrantKind === "organization" || effectiveGrantKind === "agent";
|
|
if (createsManagedGrant && !await isToolConnectionManagerQuiet(req, companyId)) {
|
|
throw forbidden(
|
|
effectiveGrantKind === "agent"
|
|
? "Only connection managers can authorize a dedicated agent identity"
|
|
: ORGANIZATION_GRANT_DENIAL_REASON,
|
|
);
|
|
}
|
|
assertNotThisPaperclip(req, req.body.link);
|
|
try {
|
|
const result = await svc.connectGalleryApp(companyId, req.body, connectionRequestActor(req));
|
|
if (result.auth?.kind === "oauth") {
|
|
try {
|
|
// "Just me" must consent as the caller, not as the workspace: passing
|
|
// `subjectUserId` is what makes the callback land the tokens on the
|
|
// caller's personal grant instead of an organization grant
|
|
// (PAP-17835). The service refuses any subject other than the actor,
|
|
// so this cannot start consent on someone else's behalf.
|
|
const personalSubjectUserId = (req.actor.type === "agent" || req.body.grantKind === "user") ? connectionRequestUserId(req) ?? null : null;
|
|
const dedicatedSubjectAgentId = req.body.grantKind === "agent" ? req.body.subjectAgentId ?? null : null;
|
|
const start = await svc.startOAuth(companyId, result.connectionId, {
|
|
workspaceServices: req.body.workspaceServices,
|
|
redirectUri: oauthRedirectUri(req),
|
|
actor: connectionRequestActor(req),
|
|
...(personalSubjectUserId ? { subjectUserId: personalSubjectUserId } : {}),
|
|
...(dedicatedSubjectAgentId ? { subjectAgentId: dedicatedSubjectAgentId } : {}),
|
|
...(req.body.interactionId ? { interactionId: req.body.interactionId } : {}),
|
|
});
|
|
result.auth.startUrl = start.authorizationUrl;
|
|
result.auth.handoff = start.handoff;
|
|
result.auth.issuer = start.issuer ?? result.auth.issuer ?? null;
|
|
result.auth.resource = start.resource ?? result.auth.resource ?? null;
|
|
result.auth.registrationSource = start.registrationSource ?? null;
|
|
} catch (error) {
|
|
// An unknown server whose authorization server supports neither CIMD
|
|
// nor dynamic registration is not a failed connect: the draft
|
|
// connection is real and usable as soon as the operator supplies a
|
|
// client they registered themselves. Report that instead of a 4xx so
|
|
// the wizard can ask for it rather than losing the draft.
|
|
const code = error instanceof HttpError ? String((error.details as { code?: unknown })?.code ?? "") : "";
|
|
if (code !== "oauth_manual_client_required" && code !== "oauth_manual_client_rebinding_required") throw error;
|
|
result.auth.startUrl = null;
|
|
result.auth.manualClientRequired = true;
|
|
}
|
|
}
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_app.connected",
|
|
entityType: "tool_connection",
|
|
entityId: result.connectionId,
|
|
details: {
|
|
galleryKey: req.body.galleryKey ?? null,
|
|
credentialSource: result.connection.credentialSource,
|
|
link: typeof req.body.link === "string" ? redactRemoteUrlCredential(req.body.link) : null,
|
|
applicationId: result.application.id,
|
|
catalogEntryCount: result.catalog.length,
|
|
readOnlyActionCount: result.actions.readOnly.length,
|
|
canMakeChangesActionCount: result.actions.canMakeChanges.length,
|
|
},
|
|
});
|
|
res.status(201).json({ ...result, ...(result.auth?.kind === "oauth" && result.auth.startUrl
|
|
? requiredConnectionUserAction(req, { type: "connection", id: result.connectionId, companyId }, result.auth.startUrl,
|
|
"Open this saved setup and authenticate the account in your browser.") : {}) });
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
// Machine sign-in (MCP OAuth client credentials): organization connections
|
|
// that authenticate as a registered client, with no person signing in.
|
|
router.post("/companies/:companyId/tools/machine-sign-in", managementGuard("connections:configure", "POST /companies/:companyId/tools/machine-sign-in"), validate(createMachineSignInSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
if (!await isToolConnectionManagerQuiet(req, companyId)) throw forbidden(ORGANIZATION_GRANT_DENIAL_REASON);
|
|
try {
|
|
const result = await svc.createMachineSignIn(companyId, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.machine_sign_in_created",
|
|
entityType: "tool_connection",
|
|
entityId: result.connectionId,
|
|
details: machineSignInActivityDetails(result.machineSignIn),
|
|
});
|
|
res.status(201).json(result);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/machine-sign-in", managementGuard("connections:configure", "GET /tool-connections/:connectionId/machine-sign-in"), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
res.json(await svc.getMachineSignIn(existing.companyId, existing.id));
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/aws-setup", managementGuard("connections:configure", "GET /tool-connections/:connectionId/aws-setup"), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
// The access level being set up (it may not be saved yet, as when reconnecting) decides the template's default policy.
|
|
const accessLevel = req.query.accessLevel === "full" || req.query.accessLevel === "read_only" ? req.query.accessLevel : undefined;
|
|
res.json(await svc.getAwsSetup(existing.companyId, existing.id, { accessLevel }));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/machine-sign-in/test", managementGuard("connections:configure", "POST /tool-connections/:connectionId/machine-sign-in/test"), validate(testMachineSignInSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.testMachineSignIn(existing.companyId, existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.machine_sign_in_verified",
|
|
entityType: "tool_connection",
|
|
entityId: existing.id,
|
|
details: {
|
|
...machineSignInActivityDetails(await svc.getMachineSignIn(existing.companyId, existing.id)),
|
|
clientSecretReplaced: Boolean(req.body.clientSecret),
|
|
catalogEntryCount: result.catalog.length,
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/machine-sign-in/rotate", managementGuard("connections:configure", "POST /tool-connections/:connectionId/machine-sign-in/rotate"), validate(rotateMachineSignInSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.rotateMachineSignIn(existing.companyId, existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: result.completed ? "tool_connection.machine_sign_in_rotated" : "tool_connection.machine_sign_in_rotation_started",
|
|
entityType: "tool_connection",
|
|
entityId: existing.id,
|
|
details: machineSignInActivityDetails(result.machineSignIn),
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/machine-sign-in/rotate/complete", managementGuard("connections:configure", "POST /tool-connections/:connectionId/machine-sign-in/rotate/complete"), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.completeMachineSignInRotation(existing.companyId, existing.id, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.machine_sign_in_rotated",
|
|
entityType: "tool_connection",
|
|
entityId: existing.id,
|
|
details: machineSignInActivityDetails(result.machineSignIn),
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/connections/:connectionId/start-authorization", managementGuard("connections:configure", "POST /companies/:companyId/tools/connections/:connectionId/start-authorization", { personal: true }),
|
|
validate(startConnectionAuthorizationSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
activeToolMembership(req, companyId);
|
|
if (!connectionRequestUserId(req) || connectionRequestUserId(req) !== req.body.subjectUserId) {
|
|
throw forbidden("Board users may only authorize their own connection subject");
|
|
}
|
|
const existing = await svc.getConnection(req.params.connectionId as string, companyId);
|
|
await assertToolConnectionAccess(req, existing);
|
|
const result = await svc.startOAuth(companyId, existing.id, {
|
|
redirectUri: oauthRedirectUri(req),
|
|
actor: connectionRequestActor(req),
|
|
subjectUserId: req.body.subjectUserId,
|
|
scopes: req.body.scopes,
|
|
returnTo: req.body.returnTo,
|
|
});
|
|
res.json({ ...requiredConnectionUserAction(req, { type: "connection", id: existing.id, companyId: existing.companyId }, result.authorizationUrl, "Authenticate the selected account and consent to the requested provider access."), url: result.authorizationUrl, ...(result.handoff ? { handoff: result.handoff } : {}) });
|
|
},
|
|
);
|
|
|
|
router.post("/tools/oauth/:connectionId/start", managementGuard("connections:configure", "POST /tools/oauth/:connectionId/start", { personal: true }), validate(startToolOAuthSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
const subjectUserId = (req.actor.type === "agent" || req.body?.asCurrentUser === true) ? connectionRequestUserId(req) ?? null : null;
|
|
const subjectAgentId = req.body?.asAgentId ?? null;
|
|
if (req.body?.asCurrentUser === true && !subjectUserId) {
|
|
throw forbidden("Connecting an app as yourself requires a signed-in user");
|
|
}
|
|
if (subjectUserId && existing.credentialPolicy === "per_user") {
|
|
// Personal reconnect is consent owned by the fixed subject, not a manager
|
|
// configuration action. Membership blocks viewers; the service then
|
|
// proves this caller is the connection's retained subject before it can
|
|
// create OAuth state. Shared reconnects keep the stricter configure gate.
|
|
activeToolMembership(req, existing.companyId);
|
|
} else {
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
}
|
|
const result = await svc.startOAuth(existing.companyId, existing.id, {
|
|
workspaceServices: req.body.workspaceServices,
|
|
redirectUri: oauthRedirectUri(req),
|
|
actor: connectionRequestActor(req),
|
|
returnTo: oauthBrowserOrigin(req) ?? undefined,
|
|
...(subjectUserId ? { subjectUserId } : {}),
|
|
...(subjectAgentId ? { subjectAgentId } : {}),
|
|
...(req.body?.interactionId ? { interactionId: req.body.interactionId } : {}),
|
|
});
|
|
res.json({ ...result, ...requiredConnectionUserAction(req, { type: "connection", id: existing.id, companyId: existing.companyId }, result.authorizationUrl, "Authenticate the selected account and consent to the requested provider access.") });
|
|
});
|
|
|
|
router.get("/tools/oauth/cloud-connector/enrollment", async (req, res) => {
|
|
assertBoard(req);
|
|
res.json(await reconcilePaperclipCloudConnectorEnrollmentStatus());
|
|
});
|
|
|
|
router.post("/tools/oauth/cloud-connector/enrollment", async (req, res) => {
|
|
assertInstanceAdmin(req);
|
|
const companyId = typeof req.body?.companyId === "string" ? req.body.companyId : "";
|
|
if (!companyId) throw badRequest("Paperclip Cloud enrollment requires a company");
|
|
assertCompanyAccess(req, companyId);
|
|
const origin = new URL(oauthRedirectUri(req)).origin;
|
|
const returnTo = normalizeCloudConnectorEnrollmentReturnTo(
|
|
typeof req.body?.returnTo === "string" ? req.body.returnTo : undefined,
|
|
) ?? undefined;
|
|
let status;
|
|
try {
|
|
status = await startPaperclipCloudConnectorEnrollment({
|
|
origin,
|
|
companyId,
|
|
initiatedBy: connectorEnrollmentPrincipal(req),
|
|
label: typeof req.body?.label === "string" ? req.body.label : undefined,
|
|
returnTo,
|
|
});
|
|
} catch {
|
|
throw unprocessable("Paperclip Cloud enrollment could not be started", {
|
|
code: "paperclip_cloud_connector_enrollment_failed",
|
|
});
|
|
}
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "paperclip_cloud_connector.enrollment_started",
|
|
entityType: "connector_instance",
|
|
entityId: status.instanceId ?? "pending",
|
|
details: { environment: status.environment, status: status.status },
|
|
});
|
|
res.status(201).json(status);
|
|
});
|
|
|
|
router.get("/tools/oauth/cloud-connector/enrollment-callback", async (req, res) => {
|
|
assertInstanceAdmin(req);
|
|
const enrollmentId = typeof req.query.enrollment_id === "string" ? req.query.enrollment_id : "";
|
|
const approvalCode = typeof req.query.approval_code === "string" ? req.query.approval_code : "";
|
|
const state = typeof req.query.state === "string" ? req.query.state : "";
|
|
if (!enrollmentId || !approvalCode || !state) throw badRequest("Invalid Paperclip Cloud enrollment callback");
|
|
const pending = loadPaperclipCloudConnectorIdentity()?.pending;
|
|
if (pending?.companyId && !hasCompanyAccess(req, pending.companyId)) {
|
|
throw notFound("Paperclip Cloud enrollment not found");
|
|
}
|
|
if (pending?.initiatedBy && pending.initiatedBy !== connectorEnrollmentPrincipal(req)) {
|
|
throw notFound("Paperclip Cloud enrollment not found");
|
|
}
|
|
const [company] = pending?.companyId
|
|
? await db
|
|
.select({ id: companies.id, issuePrefix: companies.issuePrefix })
|
|
.from(companies)
|
|
.where(eq(companies.id, pending.companyId))
|
|
.limit(1)
|
|
: [];
|
|
if (!company) throw notFound("Paperclip Cloud enrollment not found");
|
|
let status;
|
|
try {
|
|
status = await completePaperclipCloudConnectorEnrollment({ enrollmentId, approvalCode, state });
|
|
invalidatePaperclipCloudConnectorCapabilities();
|
|
} catch {
|
|
throw badRequest("Invalid or expired Paperclip Cloud enrollment callback");
|
|
}
|
|
if (pending?.companyId) {
|
|
await logActivity(db, {
|
|
companyId: pending.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "paperclip_cloud_connector.enrollment_completed",
|
|
entityType: "connector_instance",
|
|
entityId: status.instanceId ?? enrollmentId,
|
|
details: { environment: status.environment, status: status.status },
|
|
});
|
|
}
|
|
const returnTo = normalizeCloudConnectorEnrollmentReturnTo(pending?.returnTo);
|
|
if (returnTo && new URL(returnTo, "http://paperclip.local").searchParams.get("enrollment_host") === "dialog") {
|
|
res.set("Cache-Control", "no-store");
|
|
const intent = new URL(returnTo, "http://paperclip.local").searchParams.get("intent");
|
|
const parsedIntent = startToolOAuthSchema.safeParse({ interactionId: intent });
|
|
const interactionId = parsedIntent.success ? parsedIntent.data.interactionId : undefined;
|
|
const [interaction] = interactionId ? await db.select({ issueId: issueThreadInteractions.issueId })
|
|
.from(issueThreadInteractions)
|
|
.where(and(
|
|
eq(issueThreadInteractions.id, interactionId),
|
|
eq(issueThreadInteractions.companyId, company.id),
|
|
eq(issueThreadInteractions.addresseeUserId, req.actor.userId ?? ""),
|
|
eq(issueThreadInteractions.kind, "connection_intent"),
|
|
)).limit(1) : [];
|
|
res.type("html").send(cloudConnectorEnrollmentOutcomeHtml(company.issuePrefix, returnTo, interaction?.issueId));
|
|
return;
|
|
}
|
|
res.redirect(303, cloudConnectorEnrollmentReturnPath(company.issuePrefix, returnTo));
|
|
});
|
|
|
|
const handlePaperclipCloudConnectorCallback = async (req: Request, res: Response) => {
|
|
assertBoard(req);
|
|
const state = typeof req.query.state === "string" ? req.query.state : "";
|
|
const claimId = typeof req.query.claim_id === "string" ? req.query.claim_id : null;
|
|
const error = typeof req.query.error === "string" ? req.query.error : null;
|
|
const pendingState = state ? await svc.peekOAuthState(state) : null;
|
|
if (!pendingState && req.get("accept")?.includes("text/html") === true) {
|
|
res.type("html").send(connectionIntentOAuthOutcomeHtml({
|
|
interactionId: null,
|
|
issueId: null,
|
|
outcome: "failed",
|
|
code: "oauth_state_missing",
|
|
}));
|
|
return;
|
|
}
|
|
if (!pendingState || !hasCompanyAccess(req, pendingState.companyId)) {
|
|
throw badRequest("Invalid or expired OAuth state");
|
|
}
|
|
const pendingConnection = await svc.getConnection(pendingState.connectionId, pendingState.companyId);
|
|
const pendingConnectionIntent = await isConnectionIntent(pendingState.interactionId);
|
|
if (pendingState.subjectUserId && pendingState.subjectUserId === req.actor.userId) {
|
|
await assertToolConnectionAccess(req, pendingConnection);
|
|
} else {
|
|
await assertToolConnectionConfigureAccess(req, pendingConnection);
|
|
}
|
|
const acceptsHtml = req.get("accept")?.includes("text/html") === true;
|
|
try {
|
|
const result = await svc.completePaperclipCloudConnectorCallback({
|
|
state,
|
|
claimId,
|
|
error,
|
|
actor: getActorInfo(req),
|
|
});
|
|
const pendingConfig = pendingConnection.config ?? {};
|
|
const oauthConfig = pendingConfig.oauth && typeof pendingConfig.oauth === "object"
|
|
? pendingConfig.oauth as Record<string, unknown>
|
|
: null;
|
|
const connectorProfileValue = typeof oauthConfig?.connectorProfile === "string"
|
|
? oauthConfig.connectorProfile
|
|
: null;
|
|
const connectorProfile = connectorProfileValue && (
|
|
isGoogleWorkspaceConnectorProfileId(connectorProfileValue) || isGitHubConnectorProfileId(connectorProfileValue)
|
|
)
|
|
? connectorProfileValue
|
|
: null;
|
|
const connectorDefinition = connectorProfile
|
|
? isGitHubConnectorProfileId(connectorProfile)
|
|
? GITHUB_CONNECTOR_PROFILES[connectorProfile]
|
|
: GOOGLE_WORKSPACE_CONNECTOR_PROFILES[connectorProfile]
|
|
: null;
|
|
await logActivity(db, {
|
|
companyId: result.connection.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_connected",
|
|
entityType: "tool_connection",
|
|
entityId: result.connection.id,
|
|
details: {
|
|
applicationId: result.application.id,
|
|
catalogEntryCount: result.catalog.length,
|
|
provider: connectorDefinition?.appSlug ?? "managed",
|
|
...(connectorDefinition ? { profile: connectorProfile } : {}),
|
|
},
|
|
});
|
|
if (acceptsHtml && pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
connectionId: result.connection.id,
|
|
userId: req.actor.userId,
|
|
outcome: "connected",
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome: "connected",
|
|
openerOrigin: pendingState.returnTo,
|
|
});
|
|
return;
|
|
}
|
|
if (acceptsHtml) {
|
|
const permissionsPath = await oauthAppPath(result.connection.companyId, result.connection.id);
|
|
res.redirect(303, `${permissionsPath}?success=1`);
|
|
return;
|
|
}
|
|
res.json(result);
|
|
} catch (callbackError) {
|
|
if (!acceptsHtml) throw callbackError;
|
|
const details = callbackError instanceof HttpError && callbackError.details && typeof callbackError.details === "object"
|
|
? callbackError.details as Record<string, unknown>
|
|
: null;
|
|
await logActivity(db, {
|
|
companyId: pendingState.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_failed",
|
|
entityType: "tool_connection",
|
|
entityId: pendingState.connectionId,
|
|
details: {
|
|
code: typeof details?.code === "string"
|
|
? details.code
|
|
: callbackError instanceof HttpError ? `oauth_callback_http_${callbackError.status}` : "oauth_callback_failed",
|
|
status: callbackError instanceof HttpError ? callbackError.status : 500,
|
|
message: callbackError instanceof HttpError
|
|
? callbackError.message
|
|
: "OAuth callback failed unexpectedly.",
|
|
},
|
|
});
|
|
if (pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
const outcome = details?.code === "oauth_authorization_denied" ? "declined" : "failed";
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
userId: req.actor.userId,
|
|
outcome,
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome,
|
|
openerOrigin: pendingState.returnTo,
|
|
code: typeof details?.code === "string" ? details.code : null,
|
|
recovery: githubInstallationRecovery(typeof details?.code === "string" ? details.code : null, details),
|
|
});
|
|
return;
|
|
}
|
|
const outcome = details?.code === "oauth_authorization_denied" ? "denied" : "failed";
|
|
res.redirect(303, await oauthRecoveryPath(
|
|
pendingConnection,
|
|
outcome,
|
|
typeof details?.code === "string" ? details.code : null,
|
|
{
|
|
installationUrl: details?.installationUrl,
|
|
managementUrl: details?.managementUrl,
|
|
},
|
|
));
|
|
}
|
|
};
|
|
router.get("/tools/oauth/cloud-connector/callback", handlePaperclipCloudConnectorCallback);
|
|
router.get("/tools/oauth/paperclip-id/callback", handlePaperclipCloudConnectorCallback);
|
|
|
|
router.get("/tools/vercel-connect/callback", async (req, res) => {
|
|
assertBoard(req);
|
|
const state = typeof req.query.state === "string" ? req.query.state : "";
|
|
const error = typeof req.query.error === "string" ? req.query.error : null;
|
|
const pendingState = state ? await svc.peekOAuthState(state) : null;
|
|
if (!pendingState && req.get("accept")?.includes("text/html") === true) {
|
|
res.type("html").send(connectionIntentOAuthOutcomeHtml({
|
|
interactionId: null,
|
|
issueId: null,
|
|
outcome: "failed",
|
|
code: "oauth_state_missing",
|
|
}));
|
|
return;
|
|
}
|
|
if (!pendingState || !hasCompanyAccess(req, pendingState.companyId)) {
|
|
throw badRequest("Invalid or expired Vercel Connect state");
|
|
}
|
|
const pendingConnection = await svc.getConnection(pendingState.connectionId, pendingState.companyId);
|
|
const pendingConnectionIntent = await isConnectionIntent(pendingState.interactionId);
|
|
if (pendingState.subjectUserId && pendingState.subjectUserId === req.actor.userId) {
|
|
await assertToolConnectionAccess(req, pendingConnection);
|
|
} else {
|
|
await assertToolConnectionConfigureAccess(req, pendingConnection);
|
|
}
|
|
const acceptsHtml = req.get("accept")?.includes("text/html") === true;
|
|
try {
|
|
const result = await svc.completeVercelConnectCallback({
|
|
state,
|
|
error,
|
|
actor: getActorInfo(req),
|
|
});
|
|
await logActivity(db, {
|
|
companyId: result.connection.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_connected",
|
|
entityType: "tool_connection",
|
|
entityId: result.connection.id,
|
|
details: {
|
|
applicationId: result.application.id,
|
|
catalogEntryCount: result.catalog.length,
|
|
provider: "vercel_connect",
|
|
},
|
|
});
|
|
if (acceptsHtml && pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
connectionId: result.connection.id,
|
|
userId: req.actor.userId,
|
|
outcome: "connected",
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome: "connected",
|
|
openerOrigin: pendingState.returnTo,
|
|
});
|
|
return;
|
|
}
|
|
if (acceptsHtml) {
|
|
const permissionsPath = await oauthAppPath(result.connection.companyId, result.connection.id);
|
|
res.redirect(303, `${permissionsPath}?success=1`);
|
|
return;
|
|
}
|
|
res.json(result);
|
|
} catch (callbackError) {
|
|
if (!acceptsHtml) throw callbackError;
|
|
const details = callbackError instanceof HttpError && callbackError.details && typeof callbackError.details === "object"
|
|
? callbackError.details as Record<string, unknown>
|
|
: null;
|
|
const callbackCode = typeof details?.code === "string" ? details.code : "vercel_connect_callback_failed";
|
|
await logActivity(db, {
|
|
companyId: pendingState.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_failed",
|
|
entityType: "tool_connection",
|
|
entityId: pendingState.connectionId,
|
|
details: { code: callbackCode, provider: "vercel_connect" },
|
|
});
|
|
if (pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
const outcome = callbackCode === "oauth_authorization_denied" ? "declined" : "failed";
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
userId: req.actor.userId,
|
|
outcome,
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome,
|
|
openerOrigin: pendingState.returnTo,
|
|
});
|
|
return;
|
|
}
|
|
res.redirect(303, await oauthRecoveryPath(pendingConnection, "failed", callbackCode));
|
|
}
|
|
});
|
|
|
|
router.get("/tools/oauth/callback", async (req, res) => {
|
|
assertBoard(req);
|
|
const state = typeof req.query.state === "string" ? req.query.state : "";
|
|
const code = typeof req.query.code === "string" ? req.query.code : null;
|
|
const error = typeof req.query.error === "string" ? req.query.error : null;
|
|
// `error_description` / `error_uri` are read from neither the query nor the
|
|
// provider's body: they are provider-authored prose, and Paperclip maps the
|
|
// `error` code to its own copy instead of reflecting them (PAP-17108).
|
|
const iss = typeof req.query.iss === "string" ? req.query.iss : null;
|
|
const pendingState = state ? await svc.peekOAuthState(state) : null;
|
|
if (!pendingState && req.get("accept")?.includes("text/html") === true) {
|
|
res.type("html").send(connectionIntentOAuthOutcomeHtml({
|
|
interactionId: null,
|
|
issueId: null,
|
|
outcome: "failed",
|
|
code: "oauth_state_missing",
|
|
}));
|
|
return;
|
|
}
|
|
if (!pendingState || !hasCompanyAccess(req, pendingState.companyId)) {
|
|
throw badRequest("Invalid or expired OAuth state");
|
|
}
|
|
const pendingConnection = await svc.getConnection(pendingState.connectionId, pendingState.companyId);
|
|
const pendingConnectionIntent = await isConnectionIntent(pendingState.interactionId);
|
|
if (!pendingState.subjectUserId) {
|
|
if (!await isToolConnectionManagerQuiet(req, pendingConnection.companyId)) {
|
|
throw forbidden(ORGANIZATION_GRANT_DENIAL_REASON);
|
|
}
|
|
} else if (pendingState.subjectUserId === req.actor.userId) {
|
|
await assertToolConnectionAccess(req, pendingConnection);
|
|
} else {
|
|
await assertToolConnectionConfigureAccess(req, pendingConnection);
|
|
}
|
|
const acceptsHtml = req.get("accept")?.includes("text/html") === true;
|
|
if (acceptsHtml && isCrossSiteOAuthCallbackNavigation(req)) {
|
|
// State is only peeked above, so the same-origin repeat still owns it.
|
|
res.set("Cache-Control", "no-store");
|
|
res.set("Referrer-Policy", "no-referrer");
|
|
res.type("html").send(oauthCallbackInterstitialHtml(req.originalUrl));
|
|
return;
|
|
}
|
|
let result: Awaited<ReturnType<typeof svc.completeOAuthCallback>>;
|
|
try {
|
|
result = await svc.completeOAuthCallback({
|
|
state,
|
|
code,
|
|
error,
|
|
iss,
|
|
// A provider denial is bound and consumed by state alone. Avoid
|
|
// requiring this deployment's callback origin just to record that the
|
|
// user declined; successful code exchange still validates the origin.
|
|
redirectUri: error ? "" : oauthRedirectUri(req),
|
|
actor: getActorInfo(req),
|
|
});
|
|
} catch (callbackError) {
|
|
if (!acceptsHtml) throw callbackError;
|
|
const details = callbackError instanceof HttpError
|
|
&& callbackError.details
|
|
&& typeof callbackError.details === "object"
|
|
&& !Array.isArray(callbackError.details)
|
|
? callbackError.details as Record<string, unknown>
|
|
: null;
|
|
const callbackErrorCode = typeof details?.code === "string" ? details.code : null;
|
|
const callbackFailureCode = callbackErrorCode
|
|
?? (callbackError instanceof HttpError ? `oauth_callback_http_${callbackError.status}` : "oauth_callback_failed");
|
|
await logActivity(db, {
|
|
companyId: pendingState.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_failed",
|
|
entityType: "tool_connection",
|
|
entityId: pendingState.connectionId,
|
|
details: {
|
|
code: callbackFailureCode,
|
|
status: callbackError instanceof HttpError ? callbackError.status : 500,
|
|
// HttpError messages are Paperclip-authored. Provider-authored
|
|
// error_description/error_uri values are never read above and cannot
|
|
// be reflected into the activity stream.
|
|
message: callbackError instanceof HttpError
|
|
? callbackError.message
|
|
: "OAuth callback failed unexpectedly.",
|
|
},
|
|
});
|
|
if (pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
const outcome = callbackErrorCode === "oauth_authorization_denied" ? "declined" : "failed";
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
userId: req.actor.userId,
|
|
outcome,
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome,
|
|
openerOrigin: pendingState.returnTo,
|
|
code: callbackFailureCode,
|
|
recovery: githubInstallationRecovery(callbackErrorCode, details),
|
|
});
|
|
return;
|
|
}
|
|
res.redirect(303, await oauthRecoveryPath(
|
|
pendingConnection,
|
|
callbackErrorCode === "oauth_authorization_denied" ? "denied" : "failed",
|
|
callbackFailureCode,
|
|
));
|
|
return;
|
|
}
|
|
await logActivity(db, {
|
|
companyId: result.connection.companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_app.oauth_connected",
|
|
entityType: "tool_connection",
|
|
entityId: result.connection.id,
|
|
details: {
|
|
applicationId: result.application.id,
|
|
catalogEntryCount: result.catalog.length,
|
|
},
|
|
});
|
|
if (acceptsHtml && pendingConnectionIntent && pendingState.interactionId && req.actor.userId) {
|
|
await finishConnectionIntentOAuth({
|
|
interactionId: pendingState.interactionId,
|
|
connectionId: result.connection.id,
|
|
userId: req.actor.userId,
|
|
outcome: "connected",
|
|
canManageOrganizationGrant: await isToolConnectionManager(req, pendingConnection.companyId),
|
|
bypassCurrentMembershipCheck: bypassCurrentMembershipCheck(req),
|
|
});
|
|
sendConnectionIntentOAuthOutcome(res, {
|
|
interactionId: pendingState.interactionId,
|
|
issueId: pendingState.issueId,
|
|
outcome: "connected",
|
|
openerOrigin: pendingState.returnTo,
|
|
});
|
|
return;
|
|
}
|
|
if (acceptsHtml) {
|
|
const permissionsPath = await oauthAppPath(result.connection.companyId, result.connection.id);
|
|
res.redirect(303, `${permissionsPath}?success=1`);
|
|
return;
|
|
}
|
|
res.json(result);
|
|
});
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/apps/:connectionId/finalize-oauth-access", managementGuard("connections:configure", "POST /companies/:companyId/tools/apps/:connectionId/finalize-oauth-access", { personal: true }),
|
|
validate(finalizeOAuthAccessSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
const existing = await svc.getConnection(req.params.connectionId as string, companyId);
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.finalizeOAuthAccess(companyId, existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_app.oauth_access_finalized",
|
|
entityType: "tool_connection",
|
|
entityId: result.connection.id,
|
|
details: {
|
|
grantKind: req.body.grantKind,
|
|
profileId: result.profile.id,
|
|
profileEntryCount: result.profileEntries.length,
|
|
},
|
|
});
|
|
res.json(result);
|
|
},
|
|
);
|
|
|
|
router.post("/companies/:companyId/tools/apps/:connectionId/finish", managementGuard("connections:configure", "POST /companies/:companyId/tools/apps/:connectionId/finish", { personal: true }), validate(finishToolAppSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
const existing = await svc.getConnection(req.params.connectionId as string, companyId);
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.finishGalleryAppConnection(companyId, existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_app.finished",
|
|
entityType: "tool_connection",
|
|
entityId: result.connection.id,
|
|
details: {
|
|
profileId: result.profile.id,
|
|
profileEntryCount: result.profileEntries.length,
|
|
profileBindingCount: result.profileBindings.length,
|
|
askFirstPolicyCount: result.policies.length,
|
|
reviewedCatalogEntryCount: req.body.reviewedCatalogEntryIds?.length ?? 0,
|
|
access: req.body.access,
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/examples", managementGuard("connections:read", "GET /companies/:companyId/tools/examples", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json({ examples: await svc.listExamples(companyId) });
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/apps/attention", managementGuard("connections:read", "GET /companies/:companyId/tools/apps/attention", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const result = await svc.listAppsNeedingAttention(companyId);
|
|
const apps = await filterConnectionManagementRows(db, req, "connections:read", result.apps, row => ({ connectionId: row.connection.id }));
|
|
res.json({ ...result, apps, totals: {
|
|
connections: apps.length, health: apps.filter(app => app.healthNeedsAttention).length,
|
|
quarantinedCatalogEntries: apps.reduce((sum, app) => sum + app.quarantinedCatalogEntryCount, 0),
|
|
pendingActionRequests: apps.reduce((sum, app) => sum + app.pendingActionRequestCount, 0),
|
|
newToolsPendingReview: apps.reduce((sum, app) => sum + app.newToolsPendingReviewCount, 0),
|
|
newToolsPendingProfiles: new Set(apps.flatMap(app => app.newToolsPendingProfiles.map(profile => profile.profileId))).size,
|
|
} });
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/action-requests", managementGuard("connections:read", "GET /companies/:companyId/tools/action-requests", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const statusRaw = typeof req.query.status === "string" ? req.query.status : "pending";
|
|
const status = (TOOL_ACTION_REQUEST_STATUSES as readonly string[]).includes(statusRaw)
|
|
? (statusRaw as (typeof TOOL_ACTION_REQUEST_STATUSES)[number])
|
|
: "pending";
|
|
res.json({ actionRequests: await filterConnectionManagementRows(db, req, "connections:read", await svc.listActionRequests(companyId, status), row => ({ connectionId: row.connectionId, issueId: row.request.issueId })) });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/examples/:id/install", managementGuard("connections:configure", "POST /companies/:companyId/tools/examples/:id/install", { personal: true }), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const result = await svc.installExample(companyId, req.params.id as string, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_example.installed",
|
|
entityType: "tool_example",
|
|
entityId: result.example.id,
|
|
details: {
|
|
created: result.created,
|
|
applicationId: result.application.id,
|
|
connectionId: result.connection.id,
|
|
profileId: result.profile.id,
|
|
profileEntryCount: result.profileEntries.length,
|
|
},
|
|
});
|
|
res.status(result.created ? 201 : 200).json(result);
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/examples/:id/smoke", async (req, res) => {
|
|
assertBoard(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const result = await svc.smokeExample(companyId, req.params.id as string, getActorInfo(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_example.smoke_run",
|
|
entityType: "tool_example",
|
|
entityId: result.exampleId,
|
|
details: {
|
|
ok: result.ok,
|
|
actor: result.actor,
|
|
connectionId: result.connection.id,
|
|
profileId: result.profile.id,
|
|
checks: result.checks.map((check) => ({
|
|
name: check.name,
|
|
ok: check.ok,
|
|
toolName: check.toolName ?? null,
|
|
decision: check.decision ?? null,
|
|
reasonCode: check.reasonCode ?? null,
|
|
})),
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/applications", managementGuard("connections:read", "GET /companies/:companyId/tools/applications", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json({ applications: await svc.listApplications(companyId) });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/applications", managementGuard("connections:configure", "POST /companies/:companyId/tools/applications", { personal: true }), validate(createToolApplicationSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const application = await svc.createApplication(companyId, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_application.created",
|
|
entityType: "tool_application",
|
|
entityId: application.id,
|
|
details: { type: application.type, name: application.name },
|
|
});
|
|
res.status(201).json(application);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.patch("/tool-applications/:applicationId", managementGuard("connections:configure", "PATCH /tool-applications/:applicationId", { personal: true }), validate(updateToolApplicationSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getApplication(req.params.applicationId as string), "Tool application not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
try {
|
|
const application = await svc.updateApplication(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: application.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_application.updated",
|
|
entityType: "tool_application",
|
|
entityId: application.id,
|
|
details: { status: application.status, name: application.name },
|
|
});
|
|
res.json(application);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.delete("/tool-applications/:applicationId", managementGuard("connections:configure", "DELETE /tool-applications/:applicationId", { personal: true }), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getApplication(req.params.applicationId as string), "Tool application not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const application = await svc.deleteApplication(existing.id, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: application.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_application.deleted",
|
|
entityType: "tool_application",
|
|
entityId: application.id,
|
|
details: { type: application.type, name: application.name },
|
|
});
|
|
res.json(application);
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/connections", managementGuard("connections:read", "GET /companies/:companyId/tools/connections", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const connections = await svc.listConnections(companyId, connectionRequestUserId(req) ?? undefined);
|
|
const canManageConnections = await isToolConnectionManagerQuiet(req, companyId);
|
|
let visible = filterVisibleToolConnections(connections, { userId: connectionRequestUserId(req), canManageConnections });
|
|
if (req.actor.type === "agent") {
|
|
const management = connectionManagementService(db);
|
|
const allowed = await Promise.all(visible.map(connection => management.capability(req.actor, "connections:read", {
|
|
type: "connection_management", companyId, connectionId: connection.id,
|
|
operation: "GET /companies/:companyId/tools/connections", readOnly: true,
|
|
}, { mutation: false, readContext: connectionRequestContext(req) })));
|
|
visible = visible.filter((_, index) => allowed[index].allowed);
|
|
}
|
|
res.json({ connections: visible });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/connections", managementGuard("connections:configure", "POST /companies/:companyId/tools/connections", { personal: true }), validate(createToolConnectionSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const connection = await svc.createConnection(companyId, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.created",
|
|
entityType: "tool_connection",
|
|
entityId: connection.id,
|
|
details: {
|
|
transport: connection.transport,
|
|
status: connection.status,
|
|
enabled: connection.enabled,
|
|
credentialRefCount: (connection.credentialRefs ?? []).length + connection.credentialSecretRefs.length,
|
|
...(req.body.agentInstructions !== undefined ? { agentInstructionsChanged: true, agentInstructionsEnabled: connection.agentInstructions?.enabled ?? false } : {}),
|
|
},
|
|
});
|
|
res.status(201).json(connection);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId", managementGuard("connections:read", "GET /tool-connections/:connectionId", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(
|
|
req,
|
|
res,
|
|
svc.getConnection(req.params.connectionId as string, undefined, connectionRequestUserId(req) ?? undefined),
|
|
"Tool connection not found",
|
|
);
|
|
if (!connection) return;
|
|
res.json(connection);
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/railway/ssh", managementGuard("connections:configure", "POST /tool-connections/:connectionId/railway/ssh", { personal: true }), validate(configureRailwaySshSchema), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertToolConnectionConfigureAccess(req, connection);
|
|
const setup = await svc.configureRailwaySsh(connection.id, connection.companyId, req.body, connectionRequestActor(req)).catch((error) => {
|
|
if (error instanceof RailwayError) throw new HttpError(error.status, error.message);
|
|
throw error;
|
|
});
|
|
await logActivity(db, { companyId: connection.companyId, ...connectionRequestActor(req), action: "tool_connection.railway_ssh_updated", entityType: "tool_connection", entityId: connection.id, details: { action: req.body.action, grantId: req.body.grantId, enabled: setup?.enabled ?? false } });
|
|
res.json(setup);
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/grants", managementGuard("connections:read", "GET /tool-connections/:connectionId/grants", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const listed = await svc.listConnectionGrants(connection.id, connection.companyId);
|
|
const capabilities = await describeConnectionCapabilities(req, connection);
|
|
const membership = toolMembershipRole(req, connection.companyId);
|
|
const grantContext = {
|
|
userId: connectionRequestUserId(req) ?? null,
|
|
isManager: await isToolConnectionManagerQuiet(req, connection.companyId),
|
|
mutationCapable: membership.unrestricted || (membership.isActive && !membership.isViewer),
|
|
};
|
|
// A regular member has no reason to browse coworkers' personal identities;
|
|
// the manager kill switch does. Filtering here rather than in the UI keeps
|
|
// the list itself — not just its controls — under server policy.
|
|
const visibleGrants = listed.grants.filter((grant) =>
|
|
grant.kind === "organization"
|
|
|| capabilities.canViewOtherPersonalIdentities
|
|
|| (grantContext.userId !== null && grant.subjectUserId === grantContext.userId));
|
|
res.json({
|
|
...listed,
|
|
grants: visibleGrants.map((grant) => ({
|
|
...grant,
|
|
capabilities: describeGrantCapabilities(grant, grantContext),
|
|
})),
|
|
capabilities,
|
|
currentUserId: grantContext.userId,
|
|
members: capabilities.canConfigure
|
|
? await svc.listConnectionAudienceMembers(connection.companyId)
|
|
: [],
|
|
});
|
|
});
|
|
|
|
router.put(
|
|
"/tool-connections/:connectionId/grants/:grantId/members", managementGuard("connections:profiles", "PUT /tool-connections/:connectionId/grants/:grantId/members", { personal: true }),
|
|
validate(replaceConnectionGrantMembersSchema),
|
|
async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
// Viewer/inactive principals are rejected before anything else, so a
|
|
// read-only member can never reach the audience writer.
|
|
activeToolMembership(req, connection.companyId);
|
|
const { grants } = await svc.listConnectionGrants(connection.id, connection.companyId);
|
|
const target = grants.find((grant) => grant.id === req.params.grantId);
|
|
if (!target) throw notFound("Connection grant not found");
|
|
const isGrantCreator = Boolean(connectionRequestUserId(req) && target.createdByUserId === connectionRequestUserId(req));
|
|
if (!isGrantCreator) await assertToolConnectionConfigureAccess(req, connection);
|
|
const memberUserIds = req.body.memberUserIds as string[];
|
|
const grant = await svc.replaceConnectionGrantMembers(
|
|
connection.id,
|
|
target.id,
|
|
memberUserIds,
|
|
connectionRequestActor(req),
|
|
);
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.grant_audience_replaced",
|
|
entityType: "connection_grant",
|
|
entityId: grant.id,
|
|
details: { connectionId: connection.id, memberCount: memberUserIds.length },
|
|
});
|
|
res.json(grant);
|
|
},
|
|
);
|
|
|
|
router.post("/tool-connections/:connectionId/grants/installations", managementGuard("connections:profiles", "POST /tool-connections/:connectionId/grants/installations", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertToolConnectionConfigureAccess(req, connection);
|
|
const body = req.body && typeof req.body === "object" ? req.body as Record<string, unknown> : {};
|
|
const credentialSecretRefs = Array.isArray(body.credentialSecretRefs) ? body.credentialSecretRefs : [];
|
|
const providerTenant = body.providerTenant && typeof body.providerTenant === "object"
|
|
? body.providerTenant as { name?: string; externalId?: string }
|
|
: undefined;
|
|
const grant = await svc.addConnectionInstallation(connection.id, {
|
|
providerTenant,
|
|
credentialSecretRefs,
|
|
isDefault: body.isDefault === true,
|
|
}, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.grant_added",
|
|
entityType: "connection_grant",
|
|
entityId: grant.id,
|
|
details: { connectionId: connection.id, kind: grant.kind },
|
|
});
|
|
res.status(201).json(grant);
|
|
});
|
|
|
|
router.delete("/tool-connections/:connectionId/grants/:grantId", managementGuard("connections:configure", "DELETE /tool-connections/:connectionId/grants/:grantId", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const { grants } = await svc.listConnectionGrants(connection.id, connection.companyId);
|
|
const grantToRevoke = grants.find((grant) => grant.id === req.params.grantId);
|
|
const canRevokeOwnGrant = Boolean(
|
|
connectionRequestUserId(req)
|
|
&& grantToRevoke
|
|
&& (grantToRevoke.subjectUserId === connectionRequestUserId(req) || grantToRevoke.createdByUserId === connectionRequestUserId(req)),
|
|
);
|
|
if (!canRevokeOwnGrant) await assertToolConnectionConfigureAccess(req, connection);
|
|
const grant = await svc.revokeConnectionGrant(connection.id, req.params.grantId as string, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.grant_revoked",
|
|
entityType: "connection_grant",
|
|
entityId: grant.id,
|
|
details: { connectionId: connection.id, kind: grant.kind, ...(grant.providerAccess ? { providerAccess: grant.providerAccess } : {}) },
|
|
});
|
|
res.json(grant);
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/grants/:grantId/delegations", managementGuard("connections:profiles", "POST /tool-connections/:connectionId/grants/:grantId/delegations", { personal: true }), validate(createConnectionGrantDelegationSchema), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const ownerUserId = connectionRequestUserId(req);
|
|
if (!ownerUserId) throw forbidden("A named user is required to delegate a personal grant");
|
|
const agentId = req.body.agentId;
|
|
const delegation = await svc.createConnectionGrantDelegation(
|
|
connection.id,
|
|
req.params.grantId as string,
|
|
agentId,
|
|
ownerUserId,
|
|
connectionRequestContext(req),
|
|
);
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.grant_delegated",
|
|
entityType: "connection_grant",
|
|
entityId: req.params.grantId as string,
|
|
details: { connectionId: connection.id, delegationId: delegation.id, agentId },
|
|
});
|
|
res.status(201).json(delegation);
|
|
});
|
|
|
|
router.delete("/tool-connections/:connectionId/grants/:grantId/delegations/:delegationId", managementGuard("connections:profiles", "DELETE /tool-connections/:connectionId/grants/:grantId/delegations/:delegationId", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const { grants } = await svc.listConnectionGrants(connection.id, connection.companyId);
|
|
const grant = grants.find((candidate) => candidate.id === req.params.grantId);
|
|
if (!grant) throw notFound("Connection grant not found");
|
|
const canRevokeOwnDelegation = Boolean(connectionRequestUserId(req) && grant.subjectUserId === connectionRequestUserId(req));
|
|
if (!canRevokeOwnDelegation && !await isToolConnectionManager(req, connection.companyId)) {
|
|
throw forbidden("Only the personal grant owner or a connection manager can revoke a delegation");
|
|
}
|
|
const delegation = await svc.revokeConnectionGrantDelegation(
|
|
connection.id,
|
|
grant.id,
|
|
req.params.delegationId as string,
|
|
connectionRequestActor(req),
|
|
);
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.grant_delegation_revoked",
|
|
entityType: "connection_grant",
|
|
entityId: grant.id,
|
|
details: { connectionId: connection.id, delegationId: delegation.id, agentId: delegation.agentId },
|
|
});
|
|
res.json(delegation);
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/review-counts", managementGuard("connections:read", "GET /tool-connections/:connectionId/review-counts", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const { resource } = connectionRequestContext(req)!;
|
|
if (!hasCompanyAccess(req, resource.companyId)) throw notFound("Tool connection not found");
|
|
assertCompanyAccess(req, resource.companyId);
|
|
res.json(await svc.getConnectionReviewCounts(resource.companyId, resource.connectionId!));
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/usage", managementGuard("connections:read", "GET /tool-connections/:connectionId/usage", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const range = req.query.range === "30d" ? "30d" : req.query.range === undefined || req.query.range === "7d" ? "7d" : null;
|
|
if (!range) throw badRequest("Usage range must be 7d or 30d");
|
|
res.json(await svc.getConnectionUsage(connection.id, range, connection.companyId));
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/installs", managementGuard("connections:profiles", "GET /tool-connections/:connectionId/installs", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
res.json({ connectionId: connection.id, installs: connection.installs ?? [] });
|
|
});
|
|
|
|
router.put(
|
|
"/tool-connections/:connectionId/installs", managementGuard("connections:profiles", "PUT /tool-connections/:connectionId/installs", { personal: true }),
|
|
validate(putToolConnectionInstallsSchema),
|
|
async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
const existingInstalls = await db
|
|
.select()
|
|
.from(toolConnectionInstalls)
|
|
.where(and(
|
|
eq(toolConnectionInstalls.companyId, connection.companyId),
|
|
eq(toolConnectionInstalls.connectionId, connection.id),
|
|
));
|
|
const requestedInstalls = req.body.installs as Array<{ targetType: "company" | "agent"; targetId: string }>;
|
|
const requestedKeys = new Set(requestedInstalls.map((install) => `${install.targetType}:${install.targetId}`));
|
|
const existingKeys = new Set(existingInstalls.map((install) => `${install.targetType}:${install.targetId}`));
|
|
const changedInstalls = [
|
|
...requestedInstalls.filter((install) => !existingKeys.has(`${install.targetType}:${install.targetId}`)),
|
|
...existingInstalls.filter((install) => !requestedKeys.has(`${install.targetType}:${install.targetId}`)),
|
|
];
|
|
if (changedInstalls.some((install) => install.targetType === "company")) {
|
|
await assertToolConnectionConfigureAccess(req, connection);
|
|
}
|
|
if (changedInstalls.some((install) => install.targetType === "agent")) {
|
|
await assertToolConnectionAccess(req, connection);
|
|
const changedAgentIds = [...new Set(
|
|
changedInstalls
|
|
.filter((install) => install.targetType === "agent")
|
|
.map((install) => install.targetId),
|
|
)];
|
|
await assertAgentConnectionInstallAccess(db, req.actor, connection.companyId, changedAgentIds);
|
|
}
|
|
const snapshot = await svc.putConnectionInstalls(connection.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.installs_synced",
|
|
entityType: "tool_connection",
|
|
entityId: connection.id,
|
|
details: {
|
|
installs: snapshot.installs.map((install) => ({ targetType: install.targetType, targetId: install.targetId })),
|
|
},
|
|
});
|
|
res.json(snapshot);
|
|
},
|
|
);
|
|
|
|
router.get("/tool-connections/:connectionId/test-agents", managementGuard("connections:read", "GET /tool-connections/:connectionId/test-agents", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
if (!options.toolGateway) {
|
|
res.status(501).json({ error: "Tool gateway service is not configured" });
|
|
return;
|
|
}
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertBoardAnyToolPermission(req, connection.companyId, ["tools:use", "tools:manage_connections"]);
|
|
const rows = await db
|
|
.select({
|
|
id: agents.id,
|
|
name: agents.name,
|
|
role: agents.role,
|
|
title: agents.title,
|
|
status: agents.status,
|
|
reportsTo: agents.reportsTo,
|
|
})
|
|
.from(agents)
|
|
.where(eq(agents.companyId, connection.companyId));
|
|
const orgDepthByAgentId = agentOrgDepths(rows);
|
|
const candidates = [];
|
|
for (const agent of rows) {
|
|
try {
|
|
await assertCanTestAsAgent(req, connection.companyId, agent.id, agent);
|
|
} catch {
|
|
continue;
|
|
}
|
|
candidates.push({
|
|
id: agent.id,
|
|
name: agent.name,
|
|
role: agent.role,
|
|
title: agent.title,
|
|
status: agent.status,
|
|
orgDepth: orgDepthByAgentId.get(agent.id) ?? 0,
|
|
});
|
|
}
|
|
candidates.sort((a, b) => a.orgDepth - b.orgDepth || a.name.localeCompare(b.name));
|
|
res.json({ agents: candidates });
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/test-agents/:agentId/access", managementGuard("connections:read", "GET /tool-connections/:connectionId/test-agents/:agentId/access", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
if (!options.toolGateway) {
|
|
res.status(501).json({ error: "Tool gateway service is not configured" });
|
|
return;
|
|
}
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertBoardAnyToolPermission(req, connection.companyId, ["tools:use", "tools:manage_connections"]);
|
|
const agentId = req.params.agentId as string;
|
|
await assertCanTestAsAgent(req, connection.companyId, agentId);
|
|
const accessSummary = await options.toolGateway.summarizeConnectionAccessForAgent({
|
|
companyId: connection.companyId,
|
|
connectionId: connection.id,
|
|
agentId,
|
|
});
|
|
res.json({ access: accessSummary });
|
|
});
|
|
|
|
async function composioAppManager(req: Request, res: Response) {
|
|
assertBoardOrAgent(req);
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return null;
|
|
if (!await isToolConnectionManager(req, connection.companyId)) throw forbidden("Only a connection manager can configure apps and grant agent access");
|
|
return connection;
|
|
}
|
|
|
|
router.get("/tool-connections/:connectionId/aggregator/apps", managementGuard("connections:read", "GET /tool-connections/:connectionId/aggregator/apps", { personal: true }), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.set("Cache-Control", "private, no-store");
|
|
res.json(await svc.listAggregatorApps(connection.id, { ...connectionRequestActor(req), }));
|
|
});
|
|
router.post("/tool-connections/:connectionId/aggregator/apps/sync", managementGuard("connections:configure", "POST /tool-connections/:connectionId/aggregator/apps/sync", { personal: true }), validate(aggregatorAppsSyncSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.syncAggregatorApps(connection.id, req.body.force, { ...connectionRequestActor(req), }));
|
|
});
|
|
router.post("/tool-connections/:connectionId/aggregator/apps/refresh", managementGuard("connections:configure", "POST /tool-connections/:connectionId/aggregator/apps/refresh", { personal: true }), validate(aggregatorAppsRefreshSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.refreshAggregatorApps(connection.id, req.body.toolkits, { ...connectionRequestActor(req), }));
|
|
});
|
|
router.put("/tool-connections/:connectionId/aggregator/discovery", managementGuard("connections:configure", "PUT /tool-connections/:connectionId/aggregator/discovery", { personal: true }), validate(arcadeDiscoverySetupSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.configureArcadeDiscovery(connection.id, req.body, { ...connectionRequestActor(req), }));
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/composio/apps", managementGuard("connections:read", "GET /tool-connections/:connectionId/composio/apps", { personal: true }), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.listComposioApps(connection.id, { ...connectionRequestActor(req), }));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/composio/apps/sync", managementGuard("connections:configure", "POST /tool-connections/:connectionId/composio/apps/sync", { personal: true }), validate(composioAppsSyncSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.syncComposioApps(connection.id, req.body.force, { ...connectionRequestActor(req), }));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/composio/apps/refresh", managementGuard("connections:configure", "POST /tool-connections/:connectionId/composio/apps/refresh", { personal: true }), validate(composioAppsRefreshSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.refreshComposioApps(connection.id, req.body.toolkits, { ...connectionRequestActor(req), }));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/composio/apps/:toolkit/accounts", managementGuard("connections:configure", "POST /tool-connections/:connectionId/composio/apps/:toolkit/accounts", { personal: true }), validate(composioAppAccountSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
res.json(await svc.manageComposioAppAccount(connection.id, req.params.toolkit as string, req.body, { ...connectionRequestActor(req), }));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/composio/apps/:toolkit/setup", managementGuard("connections:configure", "POST /tool-connections/:connectionId/composio/apps/:toolkit/setup", { personal: true }), validate(composioAppSetupSchema), async (req, res) => {
|
|
const connection = await composioAppManager(req, res);
|
|
if (!connection) return;
|
|
const result = await svc.setupComposioApp(connection.id, req.params.toolkit as string, req.body,
|
|
{ ...connectionRequestActor(req), });
|
|
res.json(result);
|
|
});
|
|
|
|
// An MCP Apps view's tools/call. It runs through the connection test-call
|
|
// path, so it needs exactly what a test call needs: connection management
|
|
// (connections:test), connection access, tool permission and test-as-agent
|
|
// authority for the agent whose call recorded the view, plus task read access.
|
|
router.post("/issues/:issueId/mcp-app-views/:viewId/tool-calls", async (req, res, next) => {
|
|
assertBoard(req);
|
|
const issueId = String(req.params.issueId);
|
|
const viewId = String(req.params.viewId);
|
|
if (!UUID_PATTERN.test(issueId) || !UUID_PATTERN.test(viewId)) {
|
|
res.status(404).json({ error: "View not found" });
|
|
return;
|
|
}
|
|
const [issue] = await db.select({ id: issues.id, companyId: issues.companyId }).from(issues).where(eq(issues.id, issueId)).limit(1);
|
|
if (!(await getAccessibleResource(req, res, issue, "Task not found"))) return;
|
|
const readable = await authorizationService(db).decide({ actor: req.actor, action: "issue:read", resource: { type: "issue", companyId: issue.companyId, issueId: issue.id } });
|
|
const view = readable.allowed ? await mcpAppViewsService(db).get(issue.companyId, viewId) : null;
|
|
if (!view || view.issueId !== issue.id) {
|
|
res.status(404).json({ error: "View not found" });
|
|
return;
|
|
}
|
|
res.locals.mcpAppView = view;
|
|
// The management guard resolves the connection from this parameter.
|
|
req.params.connectionId = view.connectionId;
|
|
next();
|
|
}, managementGuard("connections:test", "POST /issues/:issueId/mcp-app-views/:viewId/tool-calls", { personal: true }), validate(mcpAppToolCallSchema), async (req, res) => {
|
|
if (!options.toolGateway) {
|
|
res.status(501).json({ error: "Tool gateway service is not configured" });
|
|
return;
|
|
}
|
|
const view = res.locals.mcpAppView as typeof toolMcpAppViews.$inferSelect;
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(view.connectionId), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertBoardAnyToolPermission(req, connection.companyId, ["tools:use", "tools:manage_connections"]);
|
|
if (!view.agentId) throw forbidden("This view's agent no longer exists");
|
|
await assertCanTestAsAgent(req, connection.companyId, view.agentId);
|
|
try {
|
|
res.json(await options.toolGateway.callMcpAppViewTool({
|
|
companyId: connection.companyId,
|
|
userId: connectionRequestUserId(req) ?? "board",
|
|
view,
|
|
toolName: req.body.name,
|
|
arguments: req.body.arguments ?? {},
|
|
}));
|
|
} catch (error) {
|
|
if (!sendToolGatewayError(res, error)) throw error;
|
|
}
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/test-calls", managementGuard("connections:test", "POST /tool-connections/:connectionId/test-calls", { personal: true }), validate(toolConnectionTestCallSchema), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
if (!options.toolGateway) {
|
|
res.status(501).json({ error: "Tool gateway service is not configured" });
|
|
return;
|
|
}
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertBoardAnyToolPermission(req, connection.companyId, ["tools:use", "tools:manage_connections"]);
|
|
await assertCanTestAsAgent(req, connection.companyId, req.body.agentId);
|
|
try {
|
|
const result = await options.toolGateway.executeTestCall({
|
|
managementContext: connectionRequestContext(req),
|
|
companyId: connection.companyId,
|
|
connectionId: connection.id,
|
|
agentId: req.body.agentId,
|
|
userId: connectionRequestUserId(req) ?? "board",
|
|
toolName: req.body.toolName,
|
|
parameters: req.body.parameters ?? {},
|
|
});
|
|
res.json(result);
|
|
} catch (error) {
|
|
if (!sendToolGatewayError(res, error)) throw error;
|
|
}
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/test-calls/:actionRequestId", managementGuard("connections:test", "GET /tool-connections/:connectionId/test-calls/:actionRequestId", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
if (!options.toolGateway) {
|
|
res.status(501).json({ error: "Tool gateway service is not configured" });
|
|
return;
|
|
}
|
|
const connection = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!connection) return;
|
|
await assertBoardAnyToolPermission(req, connection.companyId, ["tools:use", "tools:manage_connections"]);
|
|
try {
|
|
const status = await options.toolGateway.getTestCallStatus({
|
|
actor: req.actor,
|
|
companyId: connection.companyId,
|
|
connectionId: connection.id,
|
|
actionRequestId: req.params.actionRequestId as string,
|
|
});
|
|
res.json(status);
|
|
} catch (error) {
|
|
if (!sendToolGatewayError(res, error)) throw error;
|
|
}
|
|
});
|
|
|
|
router.patch("/tool-connections/:connectionId", managementGuard("connections:configure", "PATCH /tool-connections/:connectionId", { personal: true }), validate(updateToolConnectionSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
if (aiConnectionRouterPluginKey(existing)) throw badRequest("Update this connection pool through its pool settings.");
|
|
const connection = await svc.updateConnection(existing.id, req.body, connectionRequestContext(req));
|
|
const lifecycleChanges = classifyConnectionUpdate(
|
|
{ enabled: existing.enabled, config: existing.config },
|
|
{ enabled: connection.enabled, config: connection.config },
|
|
);
|
|
const baseLog = {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.updated",
|
|
entityType: "tool_connection",
|
|
entityId: connection.id,
|
|
};
|
|
if (lifecycleChanges.length === 0) {
|
|
await logActivity(db, {
|
|
...baseLog,
|
|
details: {
|
|
status: connection.status,
|
|
enabled: connection.enabled,
|
|
...(req.body.agentInstructions !== undefined ? { agentInstructionsChanged: true, agentInstructionsEnabled: connection.agentInstructions?.enabled ?? false } : {}),
|
|
credentialRefCount: (connection.credentialRefs ?? []).length + connection.credentialSecretRefs.length,
|
|
},
|
|
});
|
|
} else {
|
|
// One activity row per lifecycle change so the Activity tab renders one
|
|
// humanized row each (PAP-11284), e.g. a combined pause + allowlist edit.
|
|
for (const change of lifecycleChanges) {
|
|
await logActivity(db, {
|
|
...baseLog,
|
|
details: {
|
|
status: connection.status,
|
|
enabled: connection.enabled,
|
|
...(req.body.agentInstructions !== undefined ? { agentInstructionsChanged: true, agentInstructionsEnabled: connection.agentInstructions?.enabled ?? false } : {}),
|
|
lifecycle: change.lifecycle,
|
|
...change.details,
|
|
},
|
|
});
|
|
}
|
|
}
|
|
res.json(connection);
|
|
});
|
|
|
|
router.delete("/tool-connections/:connectionId", managementGuard("connections:configure", "DELETE /tool-connections/:connectionId", { personal: true }), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
if (aiConnectionRouterPluginKey(existing)) throw badRequest("Remove this connection pool through its revision-checked pool settings.");
|
|
const applicationBefore = await svc.getApplication(existing.applicationId);
|
|
const deleteStoredContent = req.query.deleteStoredContent === "true";
|
|
if (deleteStoredContent) assertBoard(req);
|
|
const { connection, removal } = await svc.archiveConnection(
|
|
existing.id,
|
|
existing.companyId,
|
|
connectionRequestActor(req),
|
|
);
|
|
const applicationAfter = await svc.getApplication(existing.applicationId);
|
|
// The receipt is counts and outcomes only. Removal is a revocation boundary
|
|
// (PAP-17119) and operators need to see what it tore down, but this row is
|
|
// company-readable activity, so it never carries a secret name or value.
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.archived",
|
|
entityType: "tool_connection",
|
|
entityId: connection.id,
|
|
details: {
|
|
transport: connection.transport,
|
|
...(asRecord(asRecord(existing.config).oauth).grantType === "client_credentials" ? { machineSignIn: true } : {}),
|
|
...removal,
|
|
},
|
|
});
|
|
if (applicationBefore.status !== "archived" && applicationAfter.status === "archived") {
|
|
await logActivity(db, {
|
|
companyId: applicationAfter.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_application.archived",
|
|
entityType: "tool_application",
|
|
entityId: applicationAfter.id,
|
|
details: { type: applicationAfter.type, name: applicationAfter.name, reason: "last_connection_removed" },
|
|
});
|
|
}
|
|
const contentDeletion = deleteStoredContent
|
|
? await requestStoredContentDeletion(req, connection)
|
|
: null;
|
|
res.json({ ...connection, removal, ...(contentDeletion ? { contentDeletion } : {}) });
|
|
});
|
|
|
|
async function requestStoredContentDeletion(req: Request, connection: { id: string; companyId: string }) {
|
|
const actor = getActorInfo(req);
|
|
const { deletion, created } = await contentDeletion.request(connection, {
|
|
actorType: actor.actorType,
|
|
actorId: actor.actorId,
|
|
});
|
|
if (created) {
|
|
const { stored } = await contentDeletion.storedContent(connection);
|
|
await logActivity(db, {
|
|
companyId: connection.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.content_deletion_requested",
|
|
entityType: "tool_connection",
|
|
entityId: connection.id,
|
|
details: { ...stored },
|
|
});
|
|
}
|
|
return deletion;
|
|
}
|
|
|
|
router.get("/tool-connections/:connectionId/stored-content", managementGuard("connections:configure", "GET /tool-connections/:connectionId/stored-content", { personal: true }), async (req, res) => {
|
|
assertBoard(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
res.json(await contentDeletion.storedContent(existing));
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/stored-content/deletion", managementGuard("connections:configure", "POST /tool-connections/:connectionId/stored-content/deletion", { personal: true }), async (req, res) => {
|
|
assertBoard(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
res.status(202).json({ deletion: await requestStoredContentDeletion(req, existing) });
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/stored-content/deletion", managementGuard("connections:configure", "GET /tool-connections/:connectionId/stored-content/deletion", { personal: true }), async (req, res) => {
|
|
assertBoard(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
res.json({ deletion: await contentDeletion.latestDeletion(existing) });
|
|
});
|
|
|
|
router.post("/tool-connections/:connectionId/health-check", managementGuard("connections:configure", "POST /tool-connections/:connectionId/health-check", { personal: true }), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
if (existing.credentialPolicy === "per_user") await assertToolConnectionAccess(req, existing);
|
|
else await assertToolConnectionConfigureAccess(req, existing);
|
|
res.json(await svc.checkHealth(existing.id, connectionRequestActor(req)));
|
|
});
|
|
|
|
router.post(
|
|
"/tool-connections/:connectionId/reconnect", managementGuard("connections:configure", "POST /tool-connections/:connectionId/reconnect", { personal: true }),
|
|
validate(reconnectToolAppSchema),
|
|
async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.reconnectGalleryApp(
|
|
existing.id,
|
|
existing.companyId,
|
|
req.body,
|
|
connectionRequestActor(req),
|
|
);
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_app.reconnected",
|
|
entityType: "tool_connection",
|
|
entityId: existing.id,
|
|
details: { healthStatus: result.connection.healthStatus },
|
|
});
|
|
res.json(result);
|
|
},
|
|
);
|
|
|
|
router.post("/tool-connections/:connectionId/catalog/refresh", managementGuard("connections:configure", "POST /tool-connections/:connectionId/catalog/refresh", { personal: true }), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
await assertToolConnectionConfigureAccess(req, existing);
|
|
const result = await svc.refreshCatalog(existing.id, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_connection.catalog_refresh",
|
|
entityType: "tool_connection",
|
|
entityId: existing.id,
|
|
details: {
|
|
discoveredCount: result.discoveredCount,
|
|
quarantinedCount: result.quarantinedCount,
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/catalog", managementGuard("connections:read", "GET /tool-connections/:connectionId/catalog", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
res.json({ catalog: await svc.listCatalog(existing.id, existing.companyId, getActorInfo(req)) });
|
|
});
|
|
|
|
// Provider tool icons for the task chat's tool rows. Same gate and
|
|
// visibility as the connection list: only icons of connections this viewer
|
|
// can see.
|
|
router.get("/companies/:companyId/tool-icons", managementGuard("connections:read", "GET /companies/:companyId/tool-icons", { personal: true }), async (req, res) => {
|
|
assertBoard(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const connections = await svc.listConnections(companyId, connectionRequestUserId(req) ?? undefined);
|
|
const canManageConnections = await isToolConnectionManagerQuiet(req, companyId);
|
|
const visible = filterVisibleToolConnections(connections, { userId: connectionRequestUserId(req), canManageConnections });
|
|
res.setHeader("Cache-Control", "private, max-age=300");
|
|
res.json({ icons: await listCompanyProviderToolIcons(db, companyId, visible.map(connection => connection.id)) });
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/activity", managementGuard("connections:audit", "GET /tool-connections/:connectionId/activity", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
const limitRaw = Number(req.query.limit ?? 20);
|
|
const limit = Number.isFinite(limitRaw) ? limitRaw : 20;
|
|
res.json(await svc.listConnectionActivity(existing.id, existing.companyId, limit, connectionRequestContext(req)));
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/profiles", managementGuard("connections:profiles", "GET /companies/:companyId/tools/profiles", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json({ profiles: await filterConnectionManagementRows(db, req, "connections:profiles", await svc.listProfiles(companyId), row => ({ profileId: row.id })) });
|
|
});
|
|
|
|
router.get("/tool-connections/:connectionId/profile-configuration", managementGuard("connections:profiles", "GET /tool-connections/:connectionId/profile-configuration", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getConnection(req.params.connectionId as string), "Tool connection not found");
|
|
if (!existing) return;
|
|
const profiles = await svc.listConnectionProfileConfiguration(existing.companyId, existing.id,
|
|
rows => filterConnectionManagementRows(db, req, "connections:profiles", rows, row => ({ profileId: row.id })));
|
|
res.json({ profiles });
|
|
});
|
|
|
|
router.get("/tool-profiles/:profileId/new-tools", managementGuard("connections:profiles", "GET /tool-profiles/:profileId/new-tools", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
res.json(await svc.listProfileNewTools(existing.id, existing.companyId));
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/profiles", managementGuard("connections:profiles", "POST /companies/:companyId/tools/profiles", { personal: true }), validate(createToolProfileWithEntriesSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const profile = await svc.createProfile(companyId, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile.created",
|
|
entityType: "tool_profile",
|
|
entityId: profile.id,
|
|
details: { name: profile.name, entryCount: profile.entries.length },
|
|
});
|
|
res.status(201).json(profile);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/profiles/effective/agents/:agentId", managementGuard("connections:profiles", "GET /companies/:companyId/tools/profiles/effective/agents/:agentId", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const effective = await svc.getEffectiveProfilesForAgent(companyId, req.params.agentId as string);
|
|
const profiles = await filterConnectionManagementRows(db, req, "connections:profiles", effective.profiles, profile => ({ profileId: profile.id }));
|
|
const connectionIds = [...new Set([...effective.allowedTools.map(tool => tool.connectionId), ...effective.installedConnections.map(connection => connection.id)])];
|
|
const connections = await filterConnectionManagementRows(db, req, "connections:profiles", connectionIds, connectionId => ({ connectionId }));
|
|
if (profiles.length !== effective.profiles.length || connections.length !== connectionIds.length) throw forbidden("Effective profile resources are unavailable to this delegated principal");
|
|
res.json(effective);
|
|
});
|
|
|
|
router.patch("/tool-profiles/:profileId", managementGuard("connections:profiles", "PATCH /tool-profiles/:profileId", { personal: true }), validate(updateToolProfileWithEntriesSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
try {
|
|
const profile = await svc.updateProfile(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: profile.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile.updated",
|
|
entityType: "tool_profile",
|
|
entityId: profile.id,
|
|
details: { status: profile.status, entryCount: profile.entries.length },
|
|
});
|
|
res.json(profile);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.post("/tool-profiles/:profileId/duplicate", managementGuard("connections:profiles", "POST /tool-profiles/:profileId/duplicate", { personal: true }), validate(duplicateToolProfileSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
try {
|
|
const profile = await svc.duplicateProfile(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: profile.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile.duplicated",
|
|
entityType: "tool_profile",
|
|
entityId: profile.id,
|
|
details: {
|
|
sourceProfileId: existing.id,
|
|
name: profile.name,
|
|
entryCount: profile.entries.length,
|
|
assignmentCount: profile.summary.assignmentCount,
|
|
},
|
|
});
|
|
res.status(201).json(profile);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
});
|
|
|
|
router.delete("/tool-profiles/:profileId", managementGuard("connections:profiles", "DELETE /tool-profiles/:profileId", { personal: true }), validate(deleteToolProfileSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const result = await svc.deleteProfile(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile.deleted",
|
|
entityType: "tool_profile",
|
|
entityId: existing.id,
|
|
details: {
|
|
name: existing.name,
|
|
summary: result.summary,
|
|
reassignedToProfileId: result.reassignedToProfileId,
|
|
reassignedBindingCount: result.reassignedBindingCount,
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.post("/tool-profiles/:profileId/new-tools/review", managementGuard("connections:profiles", "POST /tool-profiles/:profileId/new-tools/review", { personal: true }), validate(reviewToolProfileNewToolsSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const result = await svc.reviewProfileNewTools(existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId: existing.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile.new_tools_reviewed",
|
|
entityType: "tool_profile",
|
|
entityId: existing.id,
|
|
details: {
|
|
allowedCount: result.allowedCount,
|
|
keptBlockedCount: result.keptBlockedCount,
|
|
reviewedCatalogEntryIds: result.reviewedCatalogEntryIds,
|
|
},
|
|
});
|
|
res.json(result);
|
|
});
|
|
|
|
router.post("/tool-profiles/:profileId/entries", managementGuard("connections:profiles", "POST /tool-profiles/:profileId/entries", { personal: true }), validate(createToolProfileEntryForProfileSchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfile(req.params.profileId as string), "Tool profile not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const entry = await svc.addProfileEntry(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: entry.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile_entry.created",
|
|
entityType: "tool_profile_entry",
|
|
entityId: entry.id,
|
|
details: { profileId: entry.profileId, selectorType: entry.selectorType, effect: entry.effect },
|
|
});
|
|
res.status(201).json(entry);
|
|
});
|
|
|
|
router.patch("/tool-profile-entries/:entryId", managementGuard("connections:profiles", "PATCH /tool-profile-entries/:entryId", { personal: true }), validate(updateToolProfileEntrySchema), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfileEntry(req.params.entryId as string), "Tool profile entry not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const entry = await svc.updateProfileEntry(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: entry.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile_entry.updated",
|
|
entityType: "tool_profile_entry",
|
|
entityId: entry.id,
|
|
details: { profileId: entry.profileId, selectorType: entry.selectorType, effect: entry.effect },
|
|
});
|
|
res.json(entry);
|
|
});
|
|
|
|
router.delete("/tool-profile-entries/:entryId", managementGuard("connections:profiles", "DELETE /tool-profile-entries/:entryId", { personal: true }), async (req, res) => {
|
|
const existing = await getAccessibleResource(req, res, svc.getProfileEntry(req.params.entryId as string), "Tool profile entry not found");
|
|
if (!existing) return;
|
|
assertToolAppMutationAccess(req, existing.companyId);
|
|
const entry = await svc.deleteProfileEntry(existing.id, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId: entry.companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile_entry.deleted",
|
|
entityType: "tool_profile_entry",
|
|
entityId: entry.id,
|
|
details: { profileId: entry.profileId },
|
|
});
|
|
res.json(entry);
|
|
});
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/profiles/:profileId/bind", managementGuard("connections:profiles", "POST /companies/:companyId/tools/profiles/:profileId/bind", { personal: true }),
|
|
validate(createToolProfileBindingForProfileSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const existing = await svc.getProfile(req.params.profileId as string, companyId);
|
|
try {
|
|
const binding = await svc.bindProfile(existing.id, req.body, connectionRequestActor(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile_binding.created",
|
|
entityType: "tool_profile_binding",
|
|
entityId: binding.id,
|
|
details: { profileId: binding.profileId, targetType: binding.targetType, targetId: binding.targetId },
|
|
});
|
|
res.status(201).json(binding);
|
|
} catch (error) {
|
|
svc.ensureNoDuplicateNameError(error);
|
|
}
|
|
},
|
|
);
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/profiles/:profileId/unbind", managementGuard("connections:profiles", "POST /companies/:companyId/tools/profiles/:profileId/unbind", { personal: true }),
|
|
validate(unbindToolProfileBindingSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const existing = await svc.getProfile(req.params.profileId as string, companyId);
|
|
const result = await svc.unbindProfile(existing.id, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_profile_binding.deleted",
|
|
entityType: "tool_profile",
|
|
entityId: existing.id,
|
|
details: { targetType: req.body.targetType, targetId: req.body.targetId, unbound: result.unbound },
|
|
});
|
|
res.json(result);
|
|
},
|
|
);
|
|
|
|
router.get("/companies/:companyId/tools/runtime-slots", managementGuard("connections:runtime", "GET /companies/:companyId/tools/runtime-slots", { personal: true }), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsRuntimeManage(req, companyId);
|
|
res.json({ runtimeSlots: await filterConnectionManagementRows(db, req, "connections:runtime", await svc.listRuntimeSlots(companyId), row => ({ connectionId: row.connectionId, issueId: row.issueId })) });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/runtime-slots/:id/stop", managementGuard("connections:runtime", "POST /companies/:companyId/tools/runtime-slots/:id/stop", { personal: true }), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsRuntimeManage(req, companyId);
|
|
res.json(await svc.stopRuntimeSlot(companyId, req.params.id as string, connectionRequestActor(req)));
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/runtime-slots/:id/restart", managementGuard("connections:runtime", "POST /companies/:companyId/tools/runtime-slots/:id/restart", { personal: true }), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsRuntimeManage(req, companyId);
|
|
res.json(await svc.restartRuntimeSlot(companyId, req.params.id as string, connectionRequestActor(req)));
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/runtime-health", managementGuard("connections:runtime", "GET /companies/:companyId/tools/runtime-health", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json(await svc.getRuntimeHealth(companyId));
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/runs/:runId/decisions", managementGuard("connections:audit", "GET /companies/:companyId/tools/runs/:runId/decisions", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const result = await svc.getRunDecisionLookup(companyId, req.params.runId as string);
|
|
res.json({ ...result, decisions: await filterConnectionManagementRows(db, req, "connections:audit", result.decisions, row => ({ connectionId: row.invocation.connectionId, issueId: row.invocation.issueId })) });
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/trust-rules", managementGuard("connections:profiles", "GET /companies/:companyId/tools/trust-rules", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json({ trustRules: await filterConnectionManagementPolicies(db, req, await policySvc.listTrustRules(companyId)) });
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/policies", managementGuard("connections:profiles", "GET /companies/:companyId/tools/policies", { personal: true }), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
res.json({ policies: await filterConnectionManagementPolicies(db, req, await policySvc.listPolicies(companyId)) });
|
|
});
|
|
|
|
// Rules UI sentence slots map exactly onto policy selectors:
|
|
// capability -> riskLevel, app -> applicationId, actions -> toolNames.
|
|
router.post("/companies/:companyId/tools/policies/reorder", managementGuard("connections:profiles", "POST /companies/:companyId/tools/policies/reorder", { personal: true }), validate(reorderToolPoliciesSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const policies = await policySvc.reorderPolicies(companyId, req.body, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_policy.reordered",
|
|
entityType: "tool_policy",
|
|
entityId: companyId,
|
|
details: {
|
|
policyIds: req.body.policyIds,
|
|
priorityStep: 100,
|
|
},
|
|
});
|
|
res.json({ policies });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/policies", managementGuard("connections:profiles", "POST /companies/:companyId/tools/policies", { personal: true }), validate(createToolPolicySchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const policy = await policySvc.createPolicy(companyId, req.body, { userId: connectionRequestUserId(req) ?? null, agentId: req.actor.agentId ?? null }, connectionRequestContext(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_policy.created",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: { name: policy.name, policyType: policy.policyType, priority: policy.priority },
|
|
});
|
|
res.status(201).json(policy);
|
|
} catch (error) {
|
|
policySvc.ensureNoDuplicatePolicyNameError(error);
|
|
}
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/policies/:policyId/duplicate", managementGuard("connections:profiles", "POST /companies/:companyId/tools/policies/:policyId/duplicate", { personal: true }), validate(duplicateToolPolicySchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const policy = await policySvc.duplicatePolicy({
|
|
companyId,
|
|
managementContext: connectionRequestContext(req),
|
|
policyId: req.params.policyId as string,
|
|
body: req.body,
|
|
actor: { userId: connectionRequestUserId(req) ?? null, agentId: req.actor.agentId ?? null },
|
|
});
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_policy.duplicated",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: {
|
|
sourcePolicyId: req.params.policyId,
|
|
name: policy.name,
|
|
enabled: policy.enabled,
|
|
priority: policy.priority,
|
|
},
|
|
});
|
|
res.status(201).json(policy);
|
|
} catch (error) {
|
|
policySvc.ensureNoDuplicatePolicyNameError(error);
|
|
}
|
|
});
|
|
|
|
router.patch("/companies/:companyId/tools/policies/:policyId", managementGuard("connections:profiles", "PATCH /companies/:companyId/tools/policies/:policyId", { personal: true }), validate(updateToolPolicySchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
try {
|
|
const policy = await policySvc.updatePolicy({
|
|
companyId,
|
|
managementContext: connectionRequestContext(req),
|
|
policyId: req.params.policyId as string,
|
|
body: req.body,
|
|
});
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_policy.updated",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: { name: policy.name, policyType: policy.policyType, enabled: policy.enabled, priority: policy.priority },
|
|
});
|
|
res.json(policy);
|
|
} catch (error) {
|
|
policySvc.ensureNoDuplicatePolicyNameError(error);
|
|
}
|
|
});
|
|
|
|
router.delete("/companies/:companyId/tools/policies/:policyId", managementGuard("connections:profiles", "DELETE /companies/:companyId/tools/policies/:policyId", { personal: true }), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const policy = await policySvc.deletePolicy({
|
|
companyId,
|
|
managementContext: connectionRequestContext(req),
|
|
policyId: req.params.policyId as string,
|
|
});
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_policy.deleted",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: { name: policy.name, policyType: policy.policyType },
|
|
});
|
|
res.json(policy);
|
|
});
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/action-requests/:actionRequestId/trust-rule",
|
|
validate(createToolTrustRuleFromActionRequestSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const policy = await policySvc.createTrustRuleFromActionRequest({
|
|
companyId,
|
|
actionRequestId: req.params.actionRequestId as string,
|
|
body: req.body,
|
|
actor: { userId: req.actor.userId ?? null },
|
|
});
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_trust_rule.created",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: {
|
|
name: policy.name,
|
|
selectors: policy.selectors,
|
|
sourceActionRequestId: req.params.actionRequestId,
|
|
},
|
|
});
|
|
res.status(201).json(policy);
|
|
},
|
|
);
|
|
|
|
router.post("/companies/:companyId/tools/trust-rules/:policyId/revoke", managementGuard("connections:profiles", "POST /companies/:companyId/tools/trust-rules/:policyId/revoke", { personal: true }), validate(revokeToolTrustRuleSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
assertToolAppMutationAccess(req, companyId);
|
|
const policy = await policySvc.revokeTrustRule({
|
|
companyId,
|
|
policyId: req.params.policyId as string,
|
|
body: req.body,
|
|
actor: { userId: connectionRequestUserId(req) ?? null, agentId: req.actor.agentId ?? null },
|
|
});
|
|
await logActivity(db, {
|
|
companyId,
|
|
...connectionRequestActor(req),
|
|
action: "tool_trust_rule.revoked",
|
|
entityType: "tool_policy",
|
|
entityId: policy.id,
|
|
details: { reason: req.body.reason ?? null },
|
|
});
|
|
res.json(policy);
|
|
});
|
|
|
|
router.get("/companies/:companyId/tools/stdio-templates", managementGuard("connections:read", "GET /companies/:companyId/tools/stdio-templates"), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsAdmin(req, companyId);
|
|
res.json({ templates: await svc.approvedStdioTemplates(companyId) });
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/stdio-templates", validate(createToolStdioCommandTemplateSchema), async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsAdmin(req, companyId);
|
|
const template = await svc.createStdioCommandTemplate(companyId, req.body, getActorInfo(req));
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_stdio_command_template.created",
|
|
entityType: "tool_stdio_command_template",
|
|
entityId: template.id ?? template.templateId,
|
|
details: {
|
|
templateId: template.templateId,
|
|
command: template.command,
|
|
argCount: template.args.length,
|
|
envKeyCount: template.envKeys.length,
|
|
toolCount: template.tools.length,
|
|
},
|
|
});
|
|
res.status(201).json(template);
|
|
});
|
|
|
|
router.post(
|
|
"/companies/:companyId/tools/stdio-templates/:templateId/disable",
|
|
validate(disableToolStdioCommandTemplateSchema),
|
|
async (req, res) => {
|
|
const companyId = req.params.companyId as string;
|
|
await assertToolsAdmin(req, companyId);
|
|
const template = await svc.disableStdioCommandTemplate(companyId, req.params.templateId as string);
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_stdio_command_template.disabled",
|
|
entityType: "tool_stdio_command_template",
|
|
entityId: template.id ?? template.templateId,
|
|
details: { templateId: template.templateId, reason: req.body.reason ?? null },
|
|
});
|
|
res.json(template);
|
|
},
|
|
);
|
|
|
|
router.post("/companies/:companyId/tools/mcp/import-json", validate(importMcpJsonSchema), async (req, res) => {
|
|
assertBoard(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const preview = await svc.previewMcpJsonImport(req.body);
|
|
await logActivity(db, {
|
|
companyId,
|
|
actorType: "user",
|
|
actorId: req.actor.userId ?? "board",
|
|
action: "tool_connection.import_mcp_json_previewed",
|
|
entityType: "tool_connection_import",
|
|
entityId: companyId,
|
|
details: { draftCount: preview.drafts.length },
|
|
});
|
|
res.json(preview);
|
|
});
|
|
|
|
router.post("/companies/:companyId/tools/policy/test", managementGuard("connections:configure", "POST /companies/:companyId/tools/policy/test", { personal: true }), validate(toolPolicyTestRequestSchema), async (req, res) => {
|
|
assertBoardOrAgent(req);
|
|
const companyId = req.params.companyId as string;
|
|
assertCompanyAccess(req, companyId);
|
|
const input = { ...req.body, companyId,
|
|
...(req.actor.type === "agent" ? { actorType: "agent", actorId: req.actor.agentId } : {}) };
|
|
const decision = await policySvc.decide(input);
|
|
let auditEvent = null;
|
|
if (input.writeAuditEvent === true) {
|
|
auditEvent = await policySvc.writeAudit(input, decision);
|
|
}
|
|
res.json({ decision, auditEvent });
|
|
});
|
|
|
|
return router;
|
|
}
|