@wegooli/identity-delegation 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wegooli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# @wegooli/identity-delegation
+
+위임을 **만들고, 거두고, 검사하는** 서버용 라이브러리.
+
+AI 에게 사람 대신 일을 시키려면 세 가지가 필요합니다. 누가 무엇을 허락했는지
+기록하고, 그 사람이 마음을 바꾸면 즉시 끄고, 받은 쪽이 "이게 정말 허락된
+일인가" 를 확인하는 것. **이 세 가지는 회사마다 글자 하나 다르지 않습니다.**
+다른 것은 그다음 — 자기 데이터를 자기 양식에 어떻게 넣는가 — 이고, 그건 영원히
+고객 몫입니다.
+
+> ⚠️ **서버에서만 씁니다.** `sk_` 비밀 키로 인증하므로 브라우저에 들어가면
+> 누구나 이 조직의 모든 위임을 만들고 지울 수 있습니다. 브라우저에서
+> 불러들이면 라이브러리가 즉시 오류를 냅니다.
+
+## 설치
+
+```bash
+npm install @wegooli/identity-delegation
+```
+
+Node 20 이상.
+
+## 켜기 — 사람이 스위치를 눌렀을 때
+
+```ts
+import { createDelegationClient } from '@wegooli/identity-delegation';
+
+const identity = createDelegationClient({
+  baseUrl: 'https://api.freezz.kr',
+  secretKey: process.env.WEGOOLI_SECRET_KEY!,
+});
+
+const { grant } = await identity.grants.ensure({
+  agentId,
+  principalId: user.id,
+  scope: 'sign:create',
+  audience: 'https://sign.wegooli.com',
+  expiresInDays: 90,
+  consentEvidence: { wording: '계약서 작성 자동화', at: new Date().toISOString() },
+});
+```
+
+**같은 (에이전트, 사람) 조합으로 여러 번 불러도 위임장은 하나입니다.** 사람은
+스위치를 두 번 누르고, 위임장이 둘이면 끌 때 하나만 꺼서는 안 멈춥니다.
+
+### 자체 인증을 쓰는 회사라면
+
+직원이 우리 로그인을 거치지 않으므로 `principalId` 가 없습니다. 대신 **그 회사
+인증서버가 서명한 진술**을 보냅니다 — "지금 이 버튼을 누른 사람은 우리 직원
+아무개다".
+
+```ts
+const { grant, principal } = await identity.grants.ensure({
+  agentId,
+  principalAssertion: await ourAuthServer.signStatement(currentUser),
+  scope: 'sign:create',
+  audience: 'https://sign.wegooli.com',
+  expiresInDays: 1,
+});
+```
+
+이 경우 **같은 호출이 갱신도 겸합니다.** 새 진술을 붙여 다시 부르면 만료일이
+하루 뒤로 밀립니다. 사람이 퇴사해 진술을 못 만들게 되면, 아무도 아무것도 안
+해도 위임장이 하루 안에 스스로 닫힙니다.
+
+진술을 만드는 법은
+[외부 주체 위임 연동 계약](https://github.com/wegooli/identity/blob/main/docs/integration/22-외부-주체-위임-연동-계약.md)
+을 보세요.
+
+## 끄기
+
+```ts
+await identity.grants.revoke(grant.id, '사용자가 화면에서 껐습니다');
+```
+
+**다음 검증 시점에 바로** 먹습니다. 이미 나가 있는 토큰도 함께 무효가 됩니다.
+
+이유를 남기면 나중에 "왜 멈췄나" 에 답할 수 있습니다 — 사람이 껐는지, 관리자가
+껐는지, 사고 대응이었는지는 전부 다른 이야기입니다.
+
+### 껐던 것을 다시 켜려 하면 거절됩니다
+
+```ts
+try {
+  await identity.grants.ensure({ /* … */ });
+} catch (e) {
+  if (e instanceof DelegationError && e.isRevokedByPrincipal) {
+    // 사람이 껐던 위임이다. 화면에서 다시 동의를 받고 reconsent: true 로 보낸다.
+  }
+}
+```
+
+오류가 아니라 **설계**입니다. 사람이 끈 위임을 백엔드가 조용히 다시 만들면 그
+사람이 누른 스위치는 아무것도 안 한 게 됩니다.
+
+## 받은 토큰 검사하기 (리소스 서버 쪽)
+
+```ts
+import { createTokenVerifier } from '@wegooli/identity-delegation';
+
+const verifier = createTokenVerifier({
+  issuer: 'https://api.freezz.kr',
+  audience: 'https://sign.wegooli.com', // 내 서비스 주소. 필수입니다
+  introspect: true, // 되돌리기 어려운 동작 앞에서는 켭니다
+});
+
+const caller = await verifier.verify(request.headers.get('authorization') ?? '');
+if (!caller.has('sign:create')) return forbidden();
+
+await createContract({
+  createdBy: caller.principalId, // 책임지는 사람
+  actorAgentId: caller.agentId,  // 실제로 누른 기계
+  grantId: caller.grantId,       // 무엇이 허락돼 있었나
+});
+```
+
+### 토큰이 담고 있는 것
+
+이 토큰은 "누가 불렀는가" 뿐 아니라 **"누구를 대신해서"** 를 담습니다
+(RFC 8693).
+
+| | |
+|---|---|
+| `caller.principalId` | 책임 주체 — 토큰의 `sub` |
+| `caller.agentId` | 행위자 — 토큰의 `act.sub` |
+| `caller.email` | 책임 주체의 이메일 |
+| `caller.grantId` / `grantVersion` | 어느 위임장에서 나온 권한인가 |
+
+순서가 거꾸로 보이지만 그게 요점입니다. **`sub` 으로 권한을 판단하던 기존
+코드가 그대로 동작합니다.** `act` 는 "사람이 아니라 기계가 했다" 를 기록에
+남기고 싶을 때만 읽으면 됩니다.
+
+그리고 그 사람이 우리 로그인 사용자든 고객사 직원이든 **토큰 모양이 같습니다.**
+둘을 구별하는 분기를 쓸 일은 없습니다.
+
+### `audience` 는 필수입니다
+
+빼면 **다른 서비스용으로 발급된 토큰이 여기서도 통과합니다.** 그러면 위임장의
+"이 토큰은 어디로 갈 수 있다" 는 제한이 아무것도 막지 않게 됩니다.
+
+### `introspect` 를 켜는 기준
+
+끄면 위임 취소를 토큰 수명(약 5분)만큼 늦게 봅니다. 계약서 발송처럼 되돌리기
+어려운 동작 앞에서는 켜고, 화면 하나 그리는 데는 켜지 않아도 됩니다.
+
+네트워크가 끊기면 **통과시킵니다.** 서명과 만료는 이미 확인했고, Identity 가
+잠깐 안 뜬다고 정상 요청이 전부 막히는 편이 더 나쁩니다. 확실히 거절된
+경우(401·403)에만 막습니다.
+
+## 내 서비스의 권한 이름 선언하기
+
+동의 화면이 그리는 문장은 **그 권한을 가진 서비스가 씁니다.** 우리가 지어내지
+않습니다.
+
+```ts
+await identity.resourceServers.declare({
+  identifier: 'https://sign.wegooli.com', // 토큰 aud 에 들어갈 값
+  displayName: '전자서명',
+  scopes: [
+    {
+      name: 'sign:read',
+      displayName: '내 전자서명 문서를 읽습니다',
+      description: '제목·상태·만든 날짜를 봅니다. 문서 내용은 보지 않습니다.',
+    },
+    {
+      name: 'sign:create',
+      displayName: '내 이름으로 계약을 만들고 보냅니다',
+      description: '상대에게 서명 링크가 발송됩니다.',
+      isSensitive: true, // 되돌리기 어려운 권한은 화면에서 눈에 띄게 그립니다
+    },
+  ],
+});
+```
+
+배포할 때마다 불러도 됩니다 — 주소가 같으면 행이 하나로 유지되고, 선언은
+통째로 바뀝니다. **권한 하나를 목록에서 빼면 그 권한은 더 이상 위임될 수
+없습니다.**
+
+`displayName` 은 **1인칭 현재형**으로 씁니다. 읽는 사람은 개발자가 아니라
+"내 이름으로 무슨 일이 벌어지는가" 를 판단하는 사람입니다.
+
+## 끄기 화면
+
+사람이 자기 화면에서 끄는 조각은 `@wegooli/identity-ui` 의
+`<DelegationManager />` 입니다. 그 컴포넌트는 스스로 네트워크를 쓰지 않고,
+`onRevoke` 를 이 라이브러리의 `grants.revoke()` 에 연결해서 씁니다 —
+비밀 키가 브라우저로 나가지 않게 하려는 것입니다.
+
+## 끄는 곳은 두 군데입니다
+
+| 누가 | 어디서 | 왜 |
+|---|---|---|
+| 본인 | 고객사 화면 (`<DelegationManager />`) | 자기가 아는 화면 |
+| 회사 | Wegooli 대시보드 | **고객사 시스템이 통째로 멈춰도 듣습니다** |
+
+두 번째가 이 제품을 쓰는 이유입니다. 첫 번째만 있으면 시스템이 고장 났을 때
+끄는 방법도 같이 고장 납니다.

package/dist/index.d.mts

@@ -0,0 +1,323 @@
+/**
+ * 위임에 관한 값들. Identity 가 돌려주는 JSON 을 그대로 옮긴 모양이다.
+ */
+/** 위임장 — "에이전트 A 가 주체 P 를 대신해 무엇까지, 언제까지" */
+interface Grant {
+    id: string;
+    organizationId: string;
+    agentId: string;
+    /** `user` = 우리 로그인 사용자, `external_user` = 고객사가 서명해서 알려준 사람, `organization` = 조직 */
+    principalKind: 'user' | 'organization' | 'external_user';
+    principalId: string;
+    scope: string;
+    allowedAudiences: string[];
+    grantedVia: string;
+    version: number;
+    expiresAt: string;
+    revokedAt?: string | null;
+    revokedReason?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** 고객사 인증서버가 서명해서 알려준 사람. 우리 로그인 사용자가 아니다. */
+interface ExternalPrincipal {
+    id: string;
+    organizationId: string;
+    issuerDid: string;
+    subject: string;
+    email?: string;
+    displayName?: string;
+    lastAssertedAt: string;
+}
+/** 위임장을 만들 때 진술로 밝혀진 사람 (진술을 보냈을 때만 온다) */
+interface AssertedPrincipal {
+    id: string;
+    kind: string;
+    issuerDid: string;
+    subject: string;
+    email?: string;
+    displayName?: string;
+}
+interface EnsureGrantResult {
+    grant: Grant;
+    /** 처음 만들어졌으면 true, 이미 있던 것을 돌려받았으면 false */
+    created: boolean;
+    principal?: AssertedPrincipal;
+}
+/** 리소스 서버가 선언하는 권한 하나 */
+interface ResourceScope {
+    name: string;
+    /** 동의 화면에 그려질 문장. 1인칭 현재형으로 쓴다 — "내 문서를 읽습니다" */
+    displayName: string;
+    description?: string;
+    /** 되돌리기 어려운 권한. 화면이 눈에 띄게 그린다 */
+    isSensitive?: boolean;
+}
+interface ResourceServer {
+    id: string;
+    organizationId: string;
+    identifier: string;
+    displayName: string;
+    description?: string;
+    metadataUrl?: string;
+    isEnabled: boolean;
+    scopes: ResourceScope[];
+}
+/** 위임 토큰이 밝혀 준 것 */
+interface AgentCaller {
+    /** 이 요청의 결과에 책임지는 사람/조직 — 토큰의 `sub` */
+    principalId: string;
+    /** `user` / `organization` / `external_user`. 없을 수도 있다 */
+    principalKind?: string;
+    /** 실제로 요청을 보낸 에이전트 — 토큰의 `act.sub` */
+    agentId: string;
+    agentType?: string;
+    /** 책임 주체의 이메일. 고객사 진술에서 왔든 우리 표에서 왔든 모양이 같다 */
+    email?: string;
+    organizationId?: string;
+    /** 어느 위임장에서 나온 권한인가. 사고 뒤 "무엇이 허락돼 있었나" 의 근거 */
+    grantId: string;
+    grantVersion?: number;
+    scopes: string[];
+    /** 이 토큰이 향하도록 허락된 주소 */
+    audience: string[];
+    expiresAt: Date;
+    /** 이 권한이 위임장에 있는가 */
+    has(scope: string): boolean;
+    /** 원본 클레임. 위의 것으로 부족할 때만 본다 */
+    claims: Record<string, unknown>;
+}
+
+interface DelegationClientOptions {
+    /** Identity 주소. 예: `https://api.freezz.kr` */
+    baseUrl: string;
+    /** `sk_live_…` 비밀 키. **브라우저에 절대 넣지 않는다** */
+    secretKey: string;
+    /** 테스트나 프록시용. 기본은 전역 fetch */
+    fetch?: typeof globalThis.fetch;
+    /** 한 요청의 제한 시간(ms). 기본 10초 */
+    timeoutMs?: number;
+}
+interface EnsureGrantOptions {
+    agentId: string;
+    /**
+     * 우리 로그인을 쓰는 사람의 id. 자체 인증 고객이라면 이 대신
+     * `principalAssertion` 을 보낸다. **둘 중 정확히 하나**만 보낸다.
+     */
+    principalId?: string;
+    /**
+     * 고객사 인증서버가 서명한 진술. "지금 이 버튼을 누른 사람은 우리 직원
+     * 아무개다" 를 서명한 문서다. 만드는 법은 통합 문서를 참고한다.
+     */
+    principalAssertion?: string;
+    /** 공백으로 구분한 권한 이름. 리소스 서버가 선언한 것만 쓸 수 있다 */
+    scope: string;
+    /** 이 위임으로 받은 토큰이 향할 수 있는 서비스 주소 */
+    audience: string | string[];
+    /** 며칠 뒤 만료할지. 외부 주체는 최대 1일 */
+    expiresInDays?: number;
+    /** 절대 시각으로 주고 싶을 때 (RFC 3339) */
+    expiresAt?: string;
+    /** 화면에서 사람이 본 문구·시각 등. 그대로 보관된다 */
+    consentEvidence?: Record<string, unknown>;
+    /**
+     * 껐던 사람이 **화면에서 다시 동의를 눌렀을 때만** true 로 보낸다.
+     * 재시도 로직이 자동으로 붙이면 안 된다 — 그 순간 끄기가 의미를 잃는다.
+     */
+    reconsent?: boolean;
+    /** RFC 9396 — 금액 한도 같은, 권한 이름으로 표현 못 하는 제한 */
+    authorizationDetails?: unknown;
+}
+interface IssueTokenOptions {
+    grantId: string;
+    audience: string;
+    /** 위임장의 권한 중 일부만 원할 때. 비우면 위임장 전체 */
+    scope?: string;
+    /**
+     * 에이전트 자신의 머신 자격증명(ZITADEL 이 발급한 JWT). Identity 는 이 값으로
+     * "이 위임장이 정말 이 에이전트 것인가" 를 확인한다.
+     */
+    machineToken: string;
+    /** 키에 묶인 에이전트라면 DPoP 증명 */
+    dpopProof?: string;
+}
+interface IssuedToken {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    scope: string;
+}
+/**
+ * Identity 의 서버 간 API 를 감싼다.
+ *
+ * ── 왜 "끄기" 가 "켜기" 와 같은 자리에 있는가 ──────────────────────────────
+ *
+ * 이 라이브러리가 존재하는 이유의 절반은 `revoke` 다. 토큰 검사만 제공하고
+ * 위임 만들기를 각자 짜게 두면, 고객마다 다르게 짜게 되고 그중 몇은 반드시
+ * **끄는 자리가 빠진 채로** 나온다. 스페이스노트에서 실제로 그렇게 됐다 —
+ * "언제든 끌 수 있습니다" 라고 화면에 적어 두고, 끄는 버튼이 없었다.
+ *
+ * 그래서 `ensure` 와 `revoke` 는 같은 객체에 있고, 인자 수도 비슷하다.
+ * 켜는 코드를 쓴 사람이 끄는 코드를 못 찾는 일이 없게 하려는 것이다.
+ */
+declare class DelegationClient {
+    private readonly baseUrl;
+    private readonly secretKey;
+    private readonly doFetch;
+    private readonly timeoutMs;
+    constructor(options: DelegationClientOptions);
+    readonly grants: {
+        /**
+         * 사람이 스위치를 켰을 때 부른다. **같은 (에이전트, 사람) 조합으로 여러 번
+         * 불러도 위임장이 하나만 생긴다** — 사람은 스위치를 두 번 누르고, 위임장이
+         * 둘이면 끌 때 하나만 꺼서는 안 멈춘다.
+         *
+         * 외부 주체(자체 인증 고객의 직원)라면 **이 호출이 갱신도 겸한다.** 새
+         * 진술을 붙여 다시 부르면 만료일이 밀린다. 진술을 못 만들게 되면(퇴사)
+         * 아무도 아무것도 안 해도 위임장이 스스로 닫힌다.
+         */
+        ensure: (options: EnsureGrantOptions) => Promise<EnsureGrantResult>;
+        /** 이 에이전트가 들고 있는 위임장들. 끄기 화면이 그리는 목록이다. */
+        list: (options: {
+            agentId: string;
+        }) => Promise<Grant[]>;
+        /**
+         * 끈다. **다음 검증 시점에 바로** 먹는다 — 이미 나가 있는 토큰도 무효가 된다.
+         *
+         * 이유를 적어 두면 나중에 "왜 멈췄나" 에 답할 수 있다. 사람이 껐는지,
+         * 관리자가 껐는지, 사고 대응이었는지가 전부 다른 이야기다.
+         */
+        revoke: (grantId: string, reason?: string) => Promise<void>;
+    };
+    readonly externalPrincipals: {
+        /** 진술로 알게 된 사람들. 우리 로그인 사용자가 아니다. */
+        list: () => Promise<ExternalPrincipal[]>;
+    };
+    readonly resourceServers: {
+        /**
+         * 내 서비스가 받는 권한 이름과 그 뜻을 선언한다. 동의 화면이 이 문장을
+         * 그대로 그린다.
+         *
+         * 배포할 때마다 불러도 된다 — 주소가 같으면 행이 하나로 유지되고, 선언은
+         * 통째로 바뀐다. 권한 하나를 목록에서 빼면 그 권한은 더 이상 위임될 수 없다.
+         */
+        declare: (options: {
+            identifier: string;
+            displayName: string;
+            description?: string;
+            metadataUrl?: string;
+            scopes: ResourceScope[];
+        }) => Promise<ResourceServer>;
+        list: () => Promise<ResourceServer[]>;
+    };
+    /**
+     * 위임장을 짧은 수명의 토큰으로 바꾼다.
+     *
+     * 이 호출은 **에이전트 자신이** 한다. 에이전트의 머신 자격증명이 필요하고,
+     * Identity 는 그것이 이 위임장의 에이전트가 맞는지 확인한다 — 없으면 유효한
+     * 머신 토큰 하나로 시스템의 모든 위임장을 쓸 수 있게 된다.
+     */
+    issueAgentToken(options: IssueTokenOptions): Promise<IssuedToken>;
+    private request;
+    private send;
+}
+/** 위임을 만들고 거두는 서버용 클라이언트를 만든다. */
+declare function createDelegationClient(options: DelegationClientOptions): DelegationClient;
+
+interface TokenVerifierOptions {
+    /** Identity 주소. 토큰의 `iss` 와 정확히 같아야 한다 */
+    issuer: string;
+    /**
+     * **내 서비스의 주소.** 토큰의 `aud` 가 이것이어야 통과한다.
+     *
+     * 필수다. 빼면 다른 서비스용으로 발급된 토큰이 여기서도 통과하고, 그 순간
+     * 위임장의 "이 토큰은 어디로 갈 수 있다" 는 제한이 아무것도 막지 않게 된다.
+     */
+    audience: string;
+    /** 기본은 `<issuer>/.well-known/jwks.json` */
+    jwksUri?: string;
+    /**
+     * 매 요청마다 Identity 에 "이 위임이 아직 살아 있나" 를 묻는다.
+     *
+     * 안 물으면 취소를 토큰 수명(약 5분)만큼 늦게 본다. 계약서 발송처럼
+     * 되돌리기 어려운 동작 앞에서는 켠다. 화면 하나 그리는 데는 안 켜도 된다.
+     */
+    introspect?: boolean;
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Identity 가 발급한 위임 토큰을 검사한다.
+ *
+ * 기존 로그인 토큰과 다른 점은 하나다. 이 토큰은 "누가 불렀는가" 뿐 아니라
+ * **"누구를 대신해서"** 를 담고 있다 (RFC 8693).
+ *
+ *   sub     = 책임 주체 — 이 요청의 결과에 책임지는 사람
+ *   act.sub = 행위자   — 실제로 요청을 보낸 에이전트
+ *
+ * 순서가 거꾸로 보이지만 그게 요점이다. **sub 으로 권한을 판단하던 기존 코드가
+ * 그대로 동작한다.** act 는 "사람이 아니라 기계가 했다" 를 기록에 남기고 싶을
+ * 때만 읽으면 된다.
+ *
+ * 그리고 그 사람이 우리 로그인 사용자든 고객사 직원이든 **토큰 모양이 같다.**
+ * 여기서 둘을 구별하는 분기를 쓸 일은 없다.
+ */
+declare class TokenVerifier {
+    private readonly issuer;
+    private readonly audience;
+    private readonly jwks;
+    private readonly introspectEnabled;
+    private readonly doFetch;
+    constructor(options: TokenVerifierOptions);
+    /**
+     * `Authorization` 헤더나 토큰 문자열을 받아 검사한다.
+     *
+     * 실패는 전부 {@link TokenRejected} 다. **거절 이유를 응답에 그대로 실어
+     * 보내지 않는다** — 어느 검사에서 걸렸는지 알려 주는 것은 공격자에게 다음
+     * 시도의 힌트를 주는 일이다. 이유는 로그에만 남긴다.
+     */
+    verify(authorizationOrToken: string): Promise<AgentCaller>;
+    /**
+     * Identity 에 위임장이 아직 살아 있는지 묻는다.
+     *
+     * **네트워크가 안 되면 통과시킨다.** 서명과 만료는 이미 확인했고, Identity 가
+     * 잠깐 안 뜬다고 정상 요청이 전부 막히는 편이 더 나쁘다. 확실히 거절된
+     * 경우(401·403)에만 막는다.
+     */
+    private stillLive;
+}
+/** 위임 토큰 검사기를 만든다. */
+declare function createTokenVerifier(options: TokenVerifierOptions): TokenVerifier;
+
+/**
+ * Identity 가 거절했을 때 던지는 오류.
+ *
+ * `code` 는 Identity 가 돌려준 기계용 값이고, `message` 는 사람이 읽을 값이다.
+ * 둘을 나눠 두는 이유는 하나다 — 어떤 거절은 재시도로 풀리지 않고 사람이 다시
+ * 눌러야 풀린다. 코드로 갈라야 그 둘을 구별할 수 있다.
+ */
+declare class DelegationError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: string;
+    constructor(status: number, code: string, message: string, details?: string);
+    /**
+     * 그 사람이 껐던 위임을 다시 만들려 했다는 뜻이다.
+     *
+     * 이건 오류가 아니라 **설계**다. 사람이 끈 위임을 백엔드가 조용히 다시 만들면
+     * 그 사람이 누른 스위치는 아무것도 안 한 게 된다. 다시 켜려면 화면에서 사람이
+     * 다시 동의를 누르고, 그 동의를 근거로 `reconsent: true` 를 보내야 한다.
+     */
+    get isRevokedByPrincipal(): boolean;
+    /** 진술이 거절됐다 — 서명·수신자·수명·발급자 중 하나가 조건을 못 맞췄다 */
+    get isAssertionRejected(): boolean;
+}
+/** 토큰 검사가 실패했을 때. 이유는 로그로만 남기고 호출자에게는 한 가지로 준다. */
+declare class TokenRejected extends Error {
+    /** 왜 거절됐는지. 응답에 그대로 실어 보내지 말 것 — 공격자에게 힌트가 된다. */
+    readonly reason: string;
+    /** 위임이 취소돼서 거절됐는가. 이건 401 이 아니라 403 이다. */
+    readonly revoked: boolean;
+    constructor(reason: string, revoked?: boolean);
+}
+
+export { type AgentCaller, type AssertedPrincipal, DelegationClient, type DelegationClientOptions, DelegationError, type EnsureGrantOptions, type EnsureGrantResult, type ExternalPrincipal, type Grant, type IssueTokenOptions, type IssuedToken, type ResourceScope, type ResourceServer, TokenRejected, TokenVerifier, type TokenVerifierOptions, createDelegationClient, createTokenVerifier };