@vess-id/ai-identity 0.0.0-dev-20260902121045

package/dist/types/grant.d.ts

@@ -0,0 +1,522 @@
+/**
+ * Grant（許可）関連の型定義
+ * VESS AI Agent Permission Gateway MVP
+ */
+/**
+ * Grant（許可）の状態
+ */
+export declare enum GrantStatus {
+    PENDING = "pending",// Agent未確定(OAuth後、Agent接続前)
+    ACTIVE = "active",
+    EXPIRED = "expired",
+    REVOKED = "revoked",
+    SUSPENDED = "suspended",
+    EXHAUSTED = "exhausted"
+}
+/**
+ * Grant（許可）のスコープ
+ *
+ * - PROJECT: プロジェクト全体に適用される Grant（全メンバーが継承）
+ * - USER: 特定ユーザーのみに適用される Grant
+ */
+export declare enum GrantScope {
+    PROJECT = "project",// Project-level Grant (全メンバーに適用)
+    USER = "user"
+}
+/**
+ * リソースタイプ
+ */
+export declare enum GrantResourceType {
+    SLACK_CHANNEL = "slack:channel",
+    SLACK_USER = "slack:user",
+    SLACK_WORKSPACE = "slack:workspace",
+    GITHUB_REPO = "github:repo",
+    GITHUB_ORG = "github:org",
+    GITHUB_ISSUE = "github:issue",
+    GOOGLE_DRIVE_FILE = "google:drive:file",
+    GOOGLE_DRIVE_FOLDER = "google:drive:folder",
+    GMAIL_THREAD = "gmail:thread",
+    GMAIL_LABEL = "gmail:label",
+    JIRA_PROJECT = "jira:project",
+    JIRA_BOARD = "jira:board",
+    JIRA_ISSUE = "jira:issue",
+    HUBSPOT_OBJECT = "hubspot:object",
+    HUBSPOT_PROPERTY = "hubspot:property",
+    HUBSPOT_SCHEMA = "hubspot:schema",
+    HUBSPOT_ASSOCIATION = "hubspot:association",
+    HUBSPOT_ENGAGEMENT = "hubspot:engagement",
+    HUBSPOT_WORKFLOW = "hubspot:workflow",
+    HUBSPOT_ACCOUNT = "hubspot:account",
+    OS_SECRET = "os:secret",
+    ANY = "*"
+}
+/**
+ * 許可されたリソース範囲
+ *
+ * Grant（許可）で指定するリソースの範囲を定義します。
+ * type、id、patternの組み合わせにより、柔軟なアクセス制御を実現します。
+ *
+ * @example 基本的な使用例
+ * ```typescript
+ * // 1. 完全一致: 特定のリソースIDのみ許可
+ * const resource1: GrantResource = {
+ *   type: "slack:channel",
+ *   id: "C123456",
+ *   name: "general"
+ * }
+ *
+ * // 2. タイプ全体: 特定タイプの全リソースを許可（セキュリティ注意）
+ * const resource2: GrantResource = {
+ *   type: "slack:channel" // 全チャンネルへのアクセスを許可
+ * }
+ *
+ * // 3. パターンマッチ: ワイルドカードを使用
+ * const resource3: GrantResource = {
+ *   type: "slack:channel",
+ *   pattern: "public-*", // "public-"で始まる全チャンネル
+ *   name: "Public channels"
+ * }
+ * ```
+ *
+ * @example 階層的タイプマッチング
+ * ```typescript
+ * // ベースタイプは全サブタイプにマッチ（セキュリティ注意）
+ * const baseType: GrantResource = {
+ *   type: "slack" // "slack:channel", "slack:message", "slack:file" など全てを許可
+ * }
+ *
+ * // ワイルドカードサフィックス
+ * const wildcardType: GrantResource = {
+ *   type: "slack:*" // "slack:channel", "slack:message" など slack: 配下の全タイプを許可
+ * }
+ *
+ * // 具体的なタイプ（推奨）
+ * const specificType: GrantResource = {
+ *   type: "slack:channel", // チャンネルのみ
+ *   pattern: "team-*" // さらにパターンで制約
+ * }
+ * ```
+ *
+ * @example セキュリティベストプラクティス
+ * ```typescript
+ * // ❌ 避けるべき設定
+ * const bad1: GrantResource = {
+ *   type: "*" // 全リソースタイプへのアクセス（最高リスク）
+ * }
+ *
+ * const bad2: GrantResource = {
+ *   type: "slack" // 全Slackリソースへのアクセス（高リスク）
+ * }
+ *
+ * // ✅ 推奨される設定
+ * const good1: GrantResource = {
+ *   type: "slack:channel",
+ *   id: "C123456" // 特定チャンネルのみ（最も安全）
+ * }
+ *
+ * const good2: GrantResource = {
+ *   type: "slack:channel",
+ *   pattern: "public-*" // パターンで制約（比較的安全）
+ * }
+ *
+ * const good3: GrantResource = {
+ *   type: "github:repo",
+ *   pattern: "org-name/*" // 特定組織のリポジトリのみ
+ * }
+ * ```
+ *
+ * @security セキュリティガイドライン
+ *
+ * 1. **最小権限の原則**: 必要最小限のアクセス権限のみを付与
+ *    - 可能な限り具体的な type を使用
+ *    - id または pattern で範囲を制限
+ *
+ * 2. **ベースタイプの危険性**:
+ *    - type: "slack" は "slack:channel", "slack:message" など全てを許可
+ *    - 意図しない広範なアクセスを与える可能性
+ *
+ * 3. **ワイルドカード使用の注意**:
+ *    - type: "*" は全リソースタイプにマッチ（本番環境では避ける）
+ *    - pattern: "*" は全IDにマッチ（極めて慎重に使用）
+ *
+ * 4. **パターン構文**:
+ *    - '*' = 0文字以上の任意の文字列（例: "test-*" → "test-1", "test-abc"）
+ *    - '?' = 1文字の任意の文字（例: "test-?" → "test-1", "test-a"）
+ *    - 正規表現として評価されるため、特殊文字のエスケープに注意
+ *
+ * 5. **ID/pattern未指定の影響**:
+ *    - id も pattern も未指定の場合、そのタイプの全リソースへのアクセスを許可
+ *    - 必ず適切な制約を設定することを推奨
+ */
+export interface GrantResource {
+    /**
+     * リソースタイプ
+     *
+     * リソースの種類を指定します。階層的な記法をサポート。
+     *
+     * 形式:
+     * - 単純: "slack", "github"
+     * - 階層的: "slack:channel", "github:repo", "drive:file"
+     * - ワイルドカード: "*", "slack:*"
+     *
+     * @example
+     * - "slack" → 全Slackリソース（channel, message, file等）
+     * - "slack:channel" → Slackチャンネルのみ
+     * - "slack:*" → slack:配下の全タイプ
+     * - "*" → 全リソースタイプ
+     */
+    type: GrantResourceType | string;
+    /**
+     * 特定リソースID（省略時はそのタイプの全リソースを許可）
+     *
+     * 具体的なリソースの識別子を指定します。
+     * 最も厳格なアクセス制御方法です。
+     *
+     * @example
+     * - "C123456" → 特定のSlackチャンネルID
+     * - "repo123" → 特定のGitHubリポジトリ
+     * - undefined → タイプの全リソースを許可（セキュリティ注意）
+     */
+    id?: string;
+    /**
+     * パターンマッチ（例: "general-*", "team-?"）
+     *
+     * ワイルドカードを使用したパターンマッチングを指定します。
+     * id よりも柔軟ですが、より広範なアクセスを許可します。
+     *
+     * パターン構文:
+     * - '*' = 0文字以上の任意の文字列
+     * - '?' = 1文字の任意の文字
+     *
+     * @example
+     * - "public-*" → "public-general", "public-test" など
+     * - "team-*-dev" → "team-frontend-dev", "team-backend-dev" など
+     * - "C??????" → Cで始まる6文字のID
+     * - "*" → 全ID（極めて慎重に使用）
+     */
+    pattern?: string;
+    /**
+     * 表示用名称
+     *
+     * UIなどでの表示に使用される人間が読める名前です。
+     * アクセス制御には影響しません。
+     *
+     * @example
+     * - "General channel"
+     * - "Public channels"
+     * - "Production repositories"
+     */
+    name?: string;
+    /**
+     * テナント/ワークスペース参照
+     *
+     * 同一プロバイダーの複数アカウントを区別するための識別子。
+     * 例: SlackのworkspaceId, JiraのcloudId, GitHubのorg名
+     *
+     * Alpha: 定義のみ、評価ロジックなし。
+     * 将来のマルチアカウント対応で使用。
+     */
+    tenant_ref?: string;
+}
+/**
+ * 時間帯制約
+ */
+export interface TimeWindowConstraint {
+    /** 許可時間帯開始（HH:mm形式） */
+    start?: string;
+    /** 許可時間帯終了（HH:mm形式） */
+    end?: string;
+    /** タイムゾーン（デフォルト: UTC） */
+    timezone?: string;
+    /** 許可曜日（0=日, 1=月...6=土） */
+    daysOfWeek?: number[];
+}
+/**
+ * 自動承認設定
+ * low-riskアクションをapprove.htmlなしで自動的にVC発行する
+ */
+export interface AutoApproveConfig {
+    /** 自動承認を有効にするか */
+    enabled: boolean;
+    /** 自動承認を許可するリスクレベル上限 (default: 'low') */
+    maxRiskLevel?: 'low' | 'medium';
+    /** 自動発行VCの最大有効期間（時間） (default: 24) */
+    maxDurationHours?: number;
+}
+/**
+ * Grant制約
+ */
+export interface GrantConstraints {
+    /** 最大実行回数 */
+    maxInvocations?: number;
+    /** 時間帯制約 */
+    timeWindow?: TimeWindowConstraint;
+    /** 有効期限（ISO 8601） - constraintsレベルでも指定可能 */
+    expiresAt?: string;
+    /** 許可IPレンジ（CIDR表記） */
+    ipAllowlist?: string[];
+    /** 許容リスクスコア上限（0-100） */
+    riskThreshold?: number;
+    /** Target constraints for secondary destinations (alpha: type only) */
+    targets?: import('./target-binding').TargetConstraint[];
+    /** 自動承認設定 */
+    autoApprove?: AutoApproveConfig;
+    /**
+     * Cedar 一元化 Step 4 — data-in-policy 許可パターン (Cedar `like` wildcard).
+     *
+     * 例: `["*@vess.id", "*@vesslabs.ai"]` → 各 recipient.address に対し
+     * `like "*@vess.id" || like "*@vesslabs.ai"` の Cedar permit rule が emit される.
+     *
+     * Spec: docs/specs/2026-05-24-cedar-unification-design.md §4.1 / §13 Step 4
+     *
+     * Phase 1 では primarily Gmail recipient address のために使う (recipient.address).
+     * Phase 2+ で per-target-binding な格納先 (channel.id 等) に拡張する.
+     */
+    allow_patterns?: string[];
+    /**
+     * Cedar 一元化 Step 4 — data-in-policy 拒否パターン (Cedar `like` wildcard).
+     *
+     * 例: `["*@competitor.com"]` → 該当 recipient で Cedar `forbid` rule が emit される.
+     * Cedar forbid-overrides-permit semantics により approval があっても denied.
+     *
+     * Spec: docs/specs/2026-05-24-cedar-unification-design.md §4.1 / §4.2 / §13 Step 4
+     */
+    deny_patterns?: string[];
+}
+/**
+ * Grant作成リクエスト
+ */
+export interface CreateGrantRequest {
+    /** 許可名（表示用） */
+    name: string;
+    /** 説明 */
+    description?: string;
+    /** Grantのスコープ (project or user) */
+    grantScope?: GrantScope;
+    /** 対象ユーザーID（USER scopeの場合は必須、PROJECT scopeの場合はnull） */
+    userId?: string;
+    /** 許可するリソース範囲 */
+    resources: GrantResource[];
+    /** 許可するアクション（例: slack.message.post） */
+    actions: string[];
+    /** 制約 */
+    constraints: GrantConstraints;
+    /** 関連プロジェクトID */
+    projectId?: string;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Grant更新リクエスト
+ */
+export interface UpdateGrantRequest {
+    /** 許可名 */
+    name?: string;
+    /** 説明 */
+    description?: string;
+    /** リソース範囲 */
+    resources?: GrantResource[];
+    /** アクション */
+    actions?: string[];
+    /** 制約 */
+    constraints?: GrantConstraints;
+    /** ステータス */
+    status?: GrantStatus;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Grant
+ */
+export interface Grant {
+    /** 一意識別子 */
+    id: string;
+    /** 許可名 */
+    name: string;
+    /** 説明 */
+    description?: string;
+    /** 許可を与えた人のDID */
+    issuerDid: string;
+    /** 許可を与えた人の名前 */
+    issuerName?: string;
+    /** Grantのスコープ (project or user) */
+    grantScope: GrantScope;
+    /** 対象ユーザーID（USER scopeの場合のみ、PROJECT scopeの場合はnull） */
+    userId?: string;
+    /** ステータス */
+    status: GrantStatus;
+    /** リソース範囲 */
+    resources: GrantResource[];
+    /** 許可アクション */
+    actions: string[];
+    /** 制約 */
+    constraints: GrantConstraints;
+    /** 現在の実行回数 */
+    currentInvocations: number;
+    /** 関連プロジェクトID */
+    projectId?: string;
+    /** 関連プロジェクト名 */
+    projectName?: string;
+    /** 作成日時 */
+    createdAt: string;
+    /** 更新日時 */
+    updatedAt: string;
+    /** 有効期限 */
+    expiresAt?: string;
+    /** 失効日時 */
+    revokedAt?: string;
+    /** 失効理由 */
+    revocationReason?: string;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Grant使用状況
+ */
+export interface GrantUsage {
+    /** GrantのID */
+    grantId: string;
+    /** 実行回数 */
+    invocationCount: number;
+    /** 最終使用日時 */
+    lastUsedAt?: string;
+    /** 残り実行回数（maxInvocationsが設定されている場合） */
+    remainingInvocations?: number;
+}
+/**
+ * Grant権限チェックリクエスト
+ */
+export interface CheckGrantPermissionRequest {
+    /** チェック対象のAgent DID */
+    agentDid: string;
+    /** チェックするアクション */
+    action: string;
+    /** チェックするリソース */
+    resource?: {
+        type: string;
+        id?: string;
+    };
+    /** 評価コンテキスト */
+    context?: {
+        ipAddress?: string;
+        timestamp?: string;
+    };
+}
+/**
+ * Grant権限チェック結果
+ */
+export interface CheckGrantPermissionResult {
+    /** 許可されているか */
+    allowed: boolean;
+    /** マッチしたGrantのID */
+    grantId?: string;
+    /** 拒否理由（allowedがfalseの場合） */
+    reason?: string;
+    /** 残り実行回数 */
+    remainingInvocations?: number;
+    /** 警告メッセージ */
+    warnings?: string[];
+}
+import { PermissionRule, PermissionConstraints } from './permission-vc';
+/**
+ * Convert Grant's GrantConstraints to PermissionConstraints format.
+ *
+ * Maps Grant-level constraints to per-rule PermissionConstraints:
+ * - maxInvocations → max_invocations
+ * - timeWindow → time (recurring)
+ * - ipAllowlist → ip_allowlist
+ * - riskThreshold → risk_threshold
+ */
+export declare function grantConstraintsToPermissionConstraints(constraints: GrantConstraints): PermissionConstraints | undefined;
+/**
+ * Normalize Grant data into PermissionRule[] for VC claims.
+ *
+ * This is the core normalization function that bridges the Grant model
+ * (user-facing, "slack:channel" combined format) to the VC model
+ * (machine-evaluated, separated provider + resource.type format).
+ *
+ * Algorithm:
+ * 1. Group actions by provider prefix (slack:*, github:*, etc.)
+ * 2. For each provider, create rules combining resources of that provider
+ * 3. Attach normalized constraints to each rule
+ *
+ * @example
+ * ```typescript
+ * const grant = {
+ *   resources: [{ type: 'slack:channel', id: 'C123' }],
+ *   actions: ['slack.message.post', 'slack.channel.read'],
+ *   constraints: { maxInvocations: 100, timeWindow: { start: '09:00', end: '18:00' } }
+ * }
+ *
+ * const rules = grantToPermissionRules(grant.resources, grant.actions, grant.constraints)
+ * // Result:
+ * // [{
+ * //   effect: 'allow',
+ * //   provider: 'slack',
+ * //   resource: { type: 'channel', id: 'C123' },
+ * //   actions: ['channel.post_message', 'channel.read_history'],
+ * //   constraints: { max_invocations: 100, time: { recurring_start: '09:00', ... } }
+ * // }]
+ * ```
+ */
+export declare function grantToPermissionRules(resources: GrantResource[], actions: string[], constraints: GrantConstraints, grantId?: string): PermissionRule[];
+/**
+ * ApprovalContext — Cedar 一元化 Step 3.5.
+ *
+ * Spec refs:
+ *   - docs/specs/2026-05-24-cedar-unification-design.md §6 (approvalContext
+ *     DTO + token ledger)
+ *   - docs/specs/2026-05-24-cedar-unification-design.md §7.2 (Cedar
+ *     context.approval shape)
+ *   - docs/specs/2026-05-24-cedar-unification-design.md §11.1
+ *     (`via_approval` event lifecycle)
+ *
+ * Carried in the body of the VC issuance API on the **retry path** (i.e.
+ * after a user clicked 承認 in the approval UI). The server consumes the
+ * single-use `token` against the approval-token ledger atomically and then
+ * injects `{ granted: true, request_id, outcome_id }` into the Cedar
+ * `context.approval` so a policy that previously returned `auth_required`
+ * now returns `permit`.
+ *
+ * Identifier formats (canonical, enforced upstream):
+ *   - `request_id`  : `'req_' + uuid`
+ *   - `outcome_id`  : `'outcome_' + uuid`
+ *   - `token`       : `'tok_' + uuid`
+ *   - `granted_at`  : ISO-8601 timestamp
+ *   - `granted_by`  : user id, or the literal `'system'` for auto-approve
+ *
+ * Replay protection invariant (spec §6):
+ *   The `token` is **single-use**. Once consumed by the ledger, a second
+ *   submission MUST be rejected as `denied_by_user` (ephemeral — does not
+ *   poison subsequent fresh requests; §5.1 OpenQ-D1 resolution).
+ */
+export interface ApprovalContext {
+    /** `req_<uuid>` — the approval-request id embedded in the initial
+     *  `auth_required` audit event. Used to reverse-link the outcome to the
+     *  triggering invocation. */
+    request_id: string;
+    /** `outcome_<uuid>` — the approval_outcome event id (Step 6 surfaces this
+     *  as a first-class row, Step 3.5 only carries it through the ledger). */
+    outcome_id: string;
+    /** `tok_<uuid>` — single-use token. Consumed atomically. */
+    token: string;
+    /** True for 承認, false for 拒否. Step 3.5 only honors `true` (the `false`
+     *  path is handled by emitting `denied_by_user` directly in the UI). */
+    granted: boolean;
+    /** ISO-8601 timestamp of the approval action. */
+    granted_at: string;
+    /** user id or `'system'` for auto-approve. */
+    granted_by: string;
+    /**
+     * HOW the consent was obtained — `'explicit'` (the user acted) or `'auto'`
+     * (consent given on their behalf). Distinct from `granted_by`, which
+     * records WHO: booking start writes `'system'` for both, because the
+     * visitor's identity is gone by issuance time.
+     *
+     * Optional and nullable on purpose. Absent means "not recorded" — rows
+     * predating the column, which are deliberately not backfilled. Readers must
+     * treat that as a third state rather than defaulting it either way.
+     */
+    consent_type?: 'explicit' | 'auto';
+}
+//# sourceMappingURL=grant.d.ts.map

package/dist/types/grant.d.ts.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,22 @@
+export * from './agent';
+export * from './vc';
+export * from './vp';
+export * from './did';
+export * from './audit';
+export * from './errors';
+export * from './connectors';
+export * from './organization';
+export * from './grant';
+export * from './receipt';
+export * from './intent';
+export * from './context';
+export * from './oauth';
+export * from './jira';
+export * from './connector-plugin';
+export * from './invitation';
+export * from './permission-mode';
+export * from './permission-vc';
+export * from './cedar-policy';
+export * from './target-binding';
+export * from './tier';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,MAAM,CAAA;AACpB,cAAc,MAAM,CAAA;AACpB,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,QAAQ,CAAA"}

package/dist/types/intent.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Intent（操作意図）関連の型定義
+ * VESS AI Agent Permission Gateway MVP
+ */
+/**
+ * リソース情報
+ */
+export interface IntentResource {
+    /** リソースタイプ（SlackChannel, DriveFile等） */
+    type: string;
+    /** リソース識別子 */
+    id?: string;
+    /** ワークスペース/フォルダ等の範囲 */
+    scope?: string;
+    /** 追加のリソース属性 */
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Intent（操作意図）
+ * SaaS依存を最小化した「操作意図」の正規化表現
+ */
+export interface Intent {
+    /** 権限主体のDID（誰の代わりに実行するか） */
+    subject: string;
+    /** 実行者のDID（Agent/User） */
+    actor: string;
+    /** 正規化アクション名（例: slack.message.post） */
+    action: string;
+    /** リソース情報 */
+    resource: IntentResource;
+    /** パラメータ */
+    parameters: Record<string, unknown>;
+    /** タイムスタンプ（ISO 8601） */
+    timestamp: string;
+    /** 相関ID（トレース用） */
+    traceId?: string;
+}
+/**
+ * 正規化されたIntent
+ */
+export interface NormalizedIntent extends Intent {
+    /** 元のツール名 */
+    originalToolName: string;
+    /** 元のアクション名 */
+    originalAction: string;
+    /** 正規化後のアクション名 */
+    normalizedAction: string;
+    /** コネクタ固有データ（SaaS固有情報を隔離） */
+    connectorSpecificData?: Record<string, unknown>;
+}
+/**
+ * Intent正規化リクエスト
+ */
+export interface NormalizeIntentRequest {
+    /** ツール名（slack, github, drive等） */
+    toolName: string;
+    /** アクション名（postMessage, createIssue等） */
+    action: string;
+    /** パラメータ */
+    parameters: Record<string, unknown>;
+    /** 実行者DID */
+    actorDid: string;
+    /** 権限主体DID（省略時はactorDid） */
+    subjectDid?: string;
+    /** 相関ID */
+    traceId?: string;
+}
+/**
+ * アクションマッピング
+ * 各コネクタのアクションを正規化アクションにマッピング
+ */
+export interface ActionMapping {
+    /** コネクタ名 */
+    connector: string;
+    /** 元のアクション名 */
+    originalAction: string;
+    /** 正規化アクション名 */
+    normalizedAction: string;
+    /** リソースタイプ */
+    resourceType: string;
+    /** 説明 */
+    description?: string;
+}
+/**
+ * Intent評価結果
+ */
+export interface IntentEvaluationResult {
+    /** 許可されているか */
+    allowed: boolean;
+    /** マッチしたGrantのID */
+    matchedGrantId?: string;
+    /** 拒否理由 */
+    reason?: string;
+    /** Obligations（追加要件） */
+    obligations?: IntentObligation[];
+    /** 警告 */
+    warnings?: string[];
+}
+/**
+ * Obligation（追加要件）
+ */
+export interface IntentObligation {
+    /** Obligationタイプ */
+    type: 'audit_enhanced' | 'mask_data' | 'require_approval' | 'rate_limit' | 'notify';
+    /** 詳細設定 */
+    config?: Record<string, unknown>;
+    /** 説明 */
+    description?: string;
+}
+/**
+ * 標準アクション定義
+ * 各コネクタで共通して使用可能なアクションカテゴリ
+ */
+export declare enum StandardActionCategory {
+    READ = "read",
+    WRITE = "write",
+    DELETE = "delete",
+    LIST = "list",
+    SEARCH = "search",
+    SHARE = "share",
+    ADMIN = "admin"
+}
+/**
+ * 標準アクションプレフィックス
+ */
+export declare const ACTION_PREFIXES: {
+    readonly SLACK: "slack";
+    readonly GITHUB: "github";
+    readonly GMAIL: "gmail";
+    readonly CALENDAR: "calendar";
+    readonly JIRA: "jira";
+};
+//# sourceMappingURL=intent.d.ts.map