Skip to content

espennilsen/pi / extensions/pi-a2a

pi-a2a

Flagged

FileKindSize
AGENTS.mdmarkdown12.0 KB
CHANGELOG.mdmarkdown1.3 KB
README.mdmarkdown11.0 KB
SKILL.mdskill md9.7 KB
agent-card-auth.test.tsscript1.7 KB
agent-card.tsscript6.1 KB
agent-executor.tsscript38.7 KB
auth-integration.test.tsscript4.6 KB
auth-selector.test.tsscript4.0 KB
auth-selector.tsscript2.6 KB
auth-types.tsscript3.7 KB
client.test.tsscript3.1 KB
client.tsscript14.9 KB
config-auth.test.tsscript4.0 KB
config.tsscript9.1 KB
cost.test.tsscript1.8 KB
hub.test.tsscript6.2 KB
hub.tsscript39.5 KB
inbound-auth.test.tsscript2.6 KB
inbound-auth.tsscript4.4 KB
index.tsscript136.5 KB
logger.tsscript1.5 KB
long-running-task-store.tsscript6.3 KB
outbound-auth.test.tsscript1.5 KB
outbound-auth.tsscript1.6 KB
package-lock.jsonmanifest149.9 KB
package.jsonmanifest1.5 KB
peer-metadata.test.tsscript3.7 KB
peer-metadata.tsscript4.6 KB
port-finder.tsscript742 B
server.tsscript12.6 KB
static-agents.tsscript5.8 KB
supervisor.test.tsscript6.1 KB
supervisor.tsscript8.4 KB
task-store.tsscript12.5 KB
token-provider.test.tsscript5.3 KB
token-provider.tsscript7.7 KB
tool-telemetry.test.tsscript2.8 KB
tool-telemetry.tsscript1.7 KB
tsconfig.jsonconfig274 B
types.tsscript11.3 KB

inbound-auth.ts

View on GitHub
/** Pure, fail-closed inbound authentication and policy checks. */

import { createHmac, timingSafeEqual } from "node:crypto";
import type { AuthMode, LocalAuthOverride } from "./auth-types.ts";
import type { LocalConfig } from "./types.ts";

export interface OAuthPrincipal {
	subject: string;
	issuer: string;
	audience: string | string[];
	expiresAt: number;
	scopes?: string[];
	/** RFC 8705 JWT confirmation thumbprint (`x5t#S256`). */
	cnfThumbprint?: string;
}
export type OAuthVerifier = (token: string) => Promise<OAuthPrincipal | null>;
export interface MtlsEvidence { verified: boolean; thumbprint?: string; }
export interface AuthenticatedPrincipal { mode: AuthMode; identity: string; }
export interface InboundAuthInput {
	authorization?: string;
	local?: Pick<LocalConfig, "apiKey" | "auth">;
	/** Actual server capabilities. This is deliberately separate from configured intent. */
	supportedModes?: AuthMode[];
	verifyOAuth?: OAuthVerifier;
	mtlsEvidence?: MtlsEvidence;
	operation?: string;
	modernOnlySkills?: string[];
}
export interface InboundAuthResult { principal?: AuthenticatedPrincipal; status?: 401 | 403; reason?: string; }

/** HTTP server currently has no TLS listener, so mTLS is not a runtime capability by default. */
export function getInboundSupportedModes(local?: Pick<LocalConfig, "apiKey" | "auth">): AuthMode[] {
	const configured = local?.auth?.supportedAuthModes;
	if (!configured) return local?.apiKey ? ["legacy-api-key"] : [];
	return configured.filter((mode): mode is AuthMode => mode === "legacy-api-key" || mode === "oauth2");
}

export async function authenticateInboundRequest(input: InboundAuthInput): Promise<InboundAuthResult> {
	const modes = input.supportedModes ?? getInboundSupportedModes(input.local);
	const token = bearerToken(input.authorization);
	if (!token) return { status: 401, reason: "missing-bearer-token" };
	const modernOnly = !!input.operation && (input.modernOnlySkills ?? input.local?.auth?.modernOnlySkills ?? []).includes(input.operation);

	const oauthMode = modes.includes("oauth2+mtls") ? "oauth2+mtls" : modes.includes("oauth2") ? "oauth2" : undefined;
	// When both modes are enabled, a valid OAuth credential takes precedence
	// over a coincidentally equal legacy API key.
	if (oauthMode && input.verifyOAuth) {
		let principal: OAuthPrincipal | null;
		try { principal = await input.verifyOAuth(token); } catch { principal = null; }
		if (principal && principal.subject && principal.issuer && principal.audience && Number.isFinite(principal.expiresAt) && principal.expiresAt > Date.now()) {
			const expected = input.local?.auth?.oauth2;
			const audiences = Array.isArray(principal.audience) ? principal.audience : [principal.audience];
			if ((expected?.issuer && principal.issuer !== expected.issuer) ||
				(expected?.audience && !audiences.includes(expected.audience)) ||
				(expected?.requiredScope && !principal.scopes?.includes(expected.requiredScope))) {
				return { status: 401, reason: "oauth-claims-rejected" };
			}
			if (oauthMode === "oauth2+mtls") {
				const evidence = input.mtlsEvidence;
				if (!evidence?.verified || !evidence.thumbprint || !principal.cnfThumbprint || !constantTimeEqual(evidence.thumbprint, principal.cnfThumbprint)) {
					return { status: 403, reason: "mtls-binding-required" };
				}
			}
			return { principal: { mode: oauthMode, identity: `oauth-${redactedIdentity(principal.subject)}` } };
		}
	}
	if (modes.includes("legacy-api-key") && input.local?.apiKey && constantTimeEqual(token, input.local.apiKey)) {
		if (modernOnly) return { status: 403, reason: "modern-auth-required" };
		return { principal: { mode: "legacy-api-key", identity: keyIdentity(token) } };
	}
	return { status: 401, reason: oauthMode && input.verifyOAuth ? "invalid-oauth-token" : "invalid-credentials" };
}

function bearerToken(value: string | undefined): string | undefined {
	return value?.startsWith("Bearer ") ? value.slice(7) || undefined : undefined;
}
/** HMAC normalizes length before timingSafeEqual. */
function constantTimeEqual(a: string, b: string): boolean {
	const key = "pi-a2a-auth";
	return timingSafeEqual(createHmac("sha256", key).update(a).digest(), createHmac("sha256", key).update(b).digest());
}
function keyIdentity(key: string): string { return `key-${createHmac("sha256", "a2a-key-id").update(key).digest("hex").slice(0, 12)}`; }
function redactedIdentity(subject: string): string { return createHmac("sha256", "a2a-oauth-id").update(subject).digest("hex").slice(0, 12); }
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall