@sayren/store-sdk 0.30.11 → 0.30.13

package/dist/index.d.mts

@@ -2272,6 +2272,83 @@ export declare const APP_SECRET_NAME_PATTERN: RegExp;
 export declare const APP_SECRETS_MAX = 20;
 export declare const APP_EVENTS_MAX = 50;
 export declare const APP_NETWORK_HOSTS_MAX = 20;
+export declare const APP_PUBLIC_HTTP_MAX = 20;
+export declare const APP_SCHEDULES_MAX = 10;
+/** HTTP 핸들러 키 — `"<메서드> <경로>"`(`@sayren/app` `defineApp({ http })`와 같은 형식) */
+export declare const APP_HTTP_KEY_PATTERN: RegExp;
+/** 예약 작업 이름 — 설정 키와 같은 형식 */
+export declare const APP_SCHEDULE_NAME_PATTERN: RegExp;
+/** 예약 작업 간격 → 분 */
+export declare const APP_SCHEDULE_INTERVALS: {
+  readonly "15m": 15;
+  readonly "30m": 30;
+  readonly "1h": 60;
+  readonly "3h": 180;
+  readonly "6h": 360;
+  readonly "12h": 720;
+  readonly "1d": 1440;
+};
+export type AppScheduleInterval = keyof typeof APP_SCHEDULE_INTERVALS;
+/** 흐름 알림 이름 — 흐름 알림 채널 `app.<handle>.<이름>`의 마지막 마디(소문자·숫자·하이픈) */
+export declare const APP_FLOW_NOTIFICATION_PATTERN: RegExp;
+/** 흐름 사건 이름 — 사건 키 `app.<handle>.<이름>`의 마지막 마디 */
+export declare const APP_FLOW_EVENT_PATTERN: RegExp;
+export declare const APP_FLOW_ITEMS_MAX = 20;
+/** 흐름 알림 매개변수 — 셀러가 편집기에서 식으로 값을 연결한다 */
+export declare const appFlowParamSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+  }>;
+  label: z.ZodString;
+  required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AppFlowParam = z.infer<typeof appFlowParamSchema>;
+export declare const appFlowNotificationSchema: z.ZodObject<{
+  label: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    type: z.ZodEnum<{
+      string: "string";
+      number: "number";
+      boolean: "boolean";
+    }>;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type AppFlowNotification = z.infer<typeof appFlowNotificationSchema>;
+export declare const appFlowEventSchema: z.ZodObject<{
+  label: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AppFlowEvent = z.infer<typeof appFlowEventSchema>;
+/** 에이전트 도구 이름 — 소문자·숫자·하이픈 */
+export declare const APP_TOOL_NAME_PATTERN: RegExp;
+export declare const appToolInputSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+  }>;
+  description: z.ZodOptional<z.ZodString>;
+  required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AppToolInput = z.infer<typeof appToolInputSchema>;
+export declare const appToolSchema: z.ZodObject<{
+  description: z.ZodString;
+  input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    type: z.ZodEnum<{
+      string: "string";
+      number: "number";
+      boolean: "boolean";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type AppTool = z.infer<typeof appToolSchema>;
 /** 앱 목록에 보이는 아이콘·README(#22 앱 목록 시안) — 앱 폴더의 파일을 `sayren app deploy`가 버전과 함께 올린다 */
 export declare const APP_ICON_MAX_BYTES: number;
 export declare const APP_ICON_MIN_PX = 512;
@@ -2288,7 +2365,27 @@ export declare const appManifestSchema: z.ZodObject<{
   supportEmail: z.ZodOptional<z.ZodEmail>;
   icon: z.ZodOptional<z.ZodString>;
   readme: z.ZodOptional<z.ZodString>;
-  runtime: z.ZodDefault<z.ZodLiteral<"code">>;
+  runtime: z.ZodDefault<z.ZodEnum<{
+    code: "code";
+    external: "external";
+  }>>;
+  external: z.ZodOptional<z.ZodObject<{
+    url: z.ZodURL;
+  }, z.core.$strict>>;
+  mcp: z.ZodOptional<z.ZodObject<{
+    tools: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+      description: z.ZodString;
+      input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+          string: "string";
+          number: "number";
+          boolean: "boolean";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
   scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
   network: z.ZodDefault<z.ZodObject<{
     hosts: z.ZodArray<z.ZodString>;
@@ -2323,6 +2420,39 @@ export declare const appManifestSchema: z.ZodObject<{
       entry: z.ZodString;
     }, z.core.$strict>;
   }, z.core.$strict>>;
+  http: z.ZodOptional<z.ZodObject<{
+    public: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>>;
+  schedules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    every: z.ZodEnum<{
+      "15m": "15m";
+      "30m": "30m";
+      "1h": "1h";
+      "3h": "3h";
+      "6h": "6h";
+      "12h": "12h";
+      "1d": "1d";
+    }>;
+  }, z.core.$strict>>>;
+  flow: z.ZodOptional<z.ZodObject<{
+    notifications: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+      label: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+          string: "string";
+          number: "number";
+          boolean: "boolean";
+        }>;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    events: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+      label: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
   settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
     type: z.ZodEnum<{
       string: "string";
@@ -2352,7 +2482,7 @@ export declare const APP_UI_MAX_BYTES: number;
 export declare const APP_UI_MAX_FILES = 2000;
 export interface AppManifestProblem {
   path: string;
-  code: "EVENT_SCOPE_MISSING" | "SELECT_OPTIONS_REQUIRED" | "SECRET_FIELD_TYPE" | "DEFAULT_TYPE_MISMATCH" | "DUPLICATE";
+  code: "EVENT_SCOPE_MISSING" | "SELECT_OPTIONS_REQUIRED" | "SECRET_FIELD_TYPE" | "DEFAULT_TYPE_MISMATCH" | "DUPLICATE" | "EXTERNAL_URL_REQUIRED" | "EXTERNAL_NETWORK_HOSTS" | "EXTERNAL_URL_INVALID";
   message: string;
 }
 /** 스키마가 보지 못하는 필드 사이 규칙 — 빌드 `VERIFY`·CLI `app verify`가 같은 결과를 낸다. 비어 있으면 통과 */
@@ -2365,6 +2495,17 @@ export interface AppCapabilities {
   events: AppEventType[];
   networkHosts: string[];
   adminPage: boolean;
+  /** 공개 HTTP 핸들러 키(`"GET /track/:id"`). 옛 버전 행에는 없다 — 읽을 때 `?? []` */
+  publicHttp?: string[];
+  /** 예약 작업 이름 → 간격. 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
+  schedules?: Record<string, AppScheduleInterval>;
+  /** 흐름 알림(이름 → 표시 이름·매개변수)·흐름 사건(이름 → 표시 이름). 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
+  flowNotifications?: Record<string, AppFlowNotification>;
+  flowEvents?: Record<string, AppFlowEvent>;
+  /** 외부 런타임의 호출 호스트(동의 화면). 코드 앱·옛 버전 행은 없다 */
+  externalHost?: string | null;
+  /** 에이전트 도구. 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
+  tools?: Record<string, AppTool>;
   /** 필수 설정 키 — 하나라도 비어 있으면 이벤트 함수를 부르지 않는다 */
   requiredSettings: string[];
   secretSettings: string[];
@@ -2375,7 +2516,7 @@ export declare function appCapabilitiesOf(manifest: AppManifest): AppCapabilitie
  * 동의 문단은 accounts 설치 화면·상점 플랫폼 앱 상세·유저 문서가 같은 문장을 쓴다.
  */
 export interface AppCapabilityDefinition {
-  key: "scopes" | "network" | "events" | "ui";
+  key: "scopes" | "network" | "events" | "ui" | "publicHttp" | "schedules" | "runtime" | "tools";
   /** 동의 화면의 문단 제목 */
   title: string;
   /** 동의 화면에 보일 줄 — 없으면 문단을 그리지 않는다 */
@@ -2384,6 +2525,37 @@ export interface AppCapabilityDefinition {
   widens(previous: AppCapabilities, next: AppCapabilities): boolean;
 }
 export declare const APP_CAPABILITIES: readonly AppCapabilityDefinition[];
+/** 요청(메서드·경로)이 HTTP 핸들러 키에 맞는가 — `:이름`은 경로 한 마디에 맞는다(`@sayren/app`의 핸들러 고르기와 같은 규칙) */
+export declare function appHttpKeyMatches(key: string, method: string, path: string): boolean;
+/** 응답용 예약 작업 목록(이름순) — 옛 버전 행(`schedules` 없음)은 빈 목록 */
+export declare function appScheduleListOf(capabilities: Pick<AppCapabilities, "schedules">): Array<{
+  name: string;
+  every: AppScheduleInterval;
+}>;
+/** 응답용 흐름 알림·사건 목록(이름순) — 옛 버전 행은 빈 목록 */
+export declare function appFlowSummaryOf(capabilities: Pick<AppCapabilities, "flowNotifications" | "flowEvents">): {
+  flowNotifications: Array<{
+    name: string;
+    label: string;
+    params: Array<{
+      name: string;
+      type: AppFlowParam["type"];
+      label: string;
+      required: boolean;
+    }>;
+  }>;
+  flowEvents: Array<{
+    name: string;
+    label: string;
+  }>;
+};
+/** 응답용 도구 목록(이름순) — 옛 버전 행은 빈 목록 */
+export declare function appToolListOf(capabilities: Pick<AppCapabilities, "tools">): Array<{
+  name: string;
+  description: string;
+}>;
+/** 예약 간격의 표시 이름 — 동의 화면·상점 플랫폼이 같이 쓴다 */
+export declare function appScheduleIntervalLabel(every: AppScheduleInterval): string;
 /** 재동의가 필요한 capability 키 — 비어 있으면 release가 모든 설치에 곧바로 반영된다 */
 export declare function appManifestWidens(previous: AppCapabilities, next: AppCapabilities): AppCapabilityDefinition["key"][];
 //#endregion
@@ -2418,6 +2590,13 @@ export declare const appInstallationStatusSchema: z.ZodEnum<{
 }>;
 export type AppInstallationStatus = z.infer<typeof appInstallationStatusSchema>;
 /** 설치 앱의 앱 정보 — 상점이 보는 범위만(개발자 비밀 값·소스·빌드는 없다) */
+/** 상점이 보는 앱 공개 범위 — 개발 중(개발자 조직) · 이 상점 전용 · 공개 */
+export declare const appVisibilitySchema: z.ZodEnum<{
+  PUBLIC: "PUBLIC";
+  DEVELOPMENT: "DEVELOPMENT";
+  PRIVATE: "PRIVATE";
+}>;
+export type AppVisibility = z.infer<typeof appVisibilitySchema>;
 export declare const appInstallationAppSchema: z.ZodObject<{
   appId: z.ZodString;
   handle: z.ZodString;
@@ -2471,6 +2650,41 @@ export declare const appInstallationSettingsUpdateSchema: z.ZodObject<{
   values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
 }, z.core.$strip>;
 export type AppInstallationSettingsUpdate = z.infer<typeof appInstallationSettingsUpdateSchema>;
+/** 예약 작업 한 줄 — 매니페스트 `schedules`의 이름과 간격 */
+export declare const appScheduleSummarySchema: z.ZodObject<{
+  name: z.ZodString;
+  every: z.ZodEnum<{
+    "15m": "15m";
+    "30m": "30m";
+    "1h": "1h";
+    "3h": "3h";
+    "6h": "6h";
+    "12h": "12h";
+    "1d": "1d";
+  }>;
+}, z.core.$strip>;
+export type AppScheduleSummary = z.infer<typeof appScheduleSummarySchema>;
+/** 흐름 알림·사건(매뉴얼 「주문 흐름에서 앱 쓰기」) — 흐름 편집기가 알림 채널·매개변수와 사건 이름을 고른다 */
+export declare const appFlowNotificationSummarySchema: z.ZodObject<{
+  name: z.ZodString;
+  label: z.ZodString;
+  params: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+      string: "string";
+      number: "number";
+      boolean: "boolean";
+    }>;
+    label: z.ZodString;
+    required: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AppFlowNotificationSummary = z.infer<typeof appFlowNotificationSummarySchema>;
+export declare const appFlowEventSummarySchema: z.ZodObject<{
+  name: z.ZodString;
+  label: z.ZodString;
+}, z.core.$strip>;
+export type AppFlowEventSummary = z.infer<typeof appFlowEventSummarySchema>;
 export declare const appInstallationSchema: z.ZodObject<{
   installationId: z.ZodString;
   storeId: z.ZodString;
@@ -2533,6 +2747,24 @@ export declare const appInstallationSchema: z.ZodObject<{
       "APP.STORE_REDACT": "APP.STORE_REDACT";
       "APP.CUSTOMER_REDACT": "APP.CUSTOMER_REDACT";
     }>>;
+    publicHttp: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    schedules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      every: z.ZodEnum<{
+        "15m": "15m";
+        "30m": "30m";
+        "1h": "1h";
+        "3h": "3h";
+        "6h": "6h";
+        "12h": "12h";
+        "1d": "1d";
+      }>;
+    }, z.core.$strip>>>;
+    tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      description: z.ZodString;
+    }, z.core.$strip>>>;
+    externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
   }, z.core.$strip>>>;
   grantedScopes: z.ZodArray<z.ZodString>;
   grantedNetworkHosts: z.ZodArray<z.ZodString>;
@@ -2562,6 +2794,42 @@ export declare const appInstallationSchema: z.ZodObject<{
     "APP.CUSTOMER_REDACT": "APP.CUSTOMER_REDACT";
   }>>;
   adminPage: z.ZodBoolean;
+  publicHttp: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  schedules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    every: z.ZodEnum<{
+      "15m": "15m";
+      "30m": "30m";
+      "1h": "1h";
+      "3h": "3h";
+      "6h": "6h";
+      "12h": "12h";
+      "1d": "1d";
+    }>;
+  }, z.core.$strip>>>;
+  tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+  }, z.core.$strip>>>;
+  externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  flowNotifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    params: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+      }>;
+      label: z.ZodString;
+      required: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  flowEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+  }, z.core.$strip>>>;
   settings: z.ZodObject<{
     fields: z.ZodRecord<z.ZodString, z.ZodObject<{
       type: z.ZodEnum<{
@@ -2683,6 +2951,11 @@ export declare const storeAppSchema: z.ZodObject<{
   developerName: z.ZodString;
   versionNumber: z.ZodNumber;
   installationId: z.ZodNullable<z.ZodString>;
+  visibility: z.ZodDefault<z.ZodEnum<{
+    PUBLIC: "PUBLIC";
+    DEVELOPMENT: "DEVELOPMENT";
+    PRIVATE: "PRIVATE";
+  }>>;
 }, z.core.$strip>;
 export type StoreApp = z.infer<typeof storeAppSchema>;
 /** `GET /v1/apps/catalog/{appId}` — 앱 상세·설치 화면 */
@@ -2695,6 +2968,11 @@ export declare const storeAppDetailSchema: z.ZodObject<{
   developerName: z.ZodString;
   versionNumber: z.ZodNumber;
   installationId: z.ZodNullable<z.ZodString>;
+  visibility: z.ZodDefault<z.ZodEnum<{
+    PUBLIC: "PUBLIC";
+    DEVELOPMENT: "DEVELOPMENT";
+    PRIVATE: "PRIVATE";
+  }>>;
   readme: z.ZodNullable<z.ZodString>;
   supportEmail: z.ZodNullable<z.ZodString>;
   scopes: z.ZodArray<z.ZodString>;
@@ -2724,6 +3002,24 @@ export declare const storeAppDetailSchema: z.ZodObject<{
     "APP.CUSTOMER_REDACT": "APP.CUSTOMER_REDACT";
   }>>;
   networkHosts: z.ZodArray<z.ZodString>;
+  publicHttp: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  schedules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    every: z.ZodEnum<{
+      "15m": "15m";
+      "30m": "30m";
+      "1h": "1h";
+      "3h": "3h";
+      "6h": "6h";
+      "12h": "12h";
+      "1d": "1d";
+    }>;
+  }, z.core.$strip>>>;
+  tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+  }, z.core.$strip>>>;
+  externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
   settings: z.ZodRecord<z.ZodString, z.ZodObject<{
     type: z.ZodEnum<{
       string: "string";
@@ -2762,6 +3058,58 @@ export declare const appInstallationSelfSchema: z.ZodObject<{
   installedAt: z.ZodString;
 }, z.core.$strip>;
 export type AppInstallationSelf = z.infer<typeof appInstallationSelfSchema>;
+/** 에이전트 도구(매뉴얼 「에이전트 도구」) — `GET /v1/apps/tools` 한 줄 */
+export declare const appToolSummarySchema: z.ZodObject<{
+  installationId: z.ZodString;
+  app: z.ZodObject<{
+    appId: z.ZodString;
+    handle: z.ZodString;
+    name: z.ZodString;
+  }, z.core.$strip>;
+  name: z.ZodString;
+  description: z.ZodString;
+  input: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+      string: "string";
+      number: "number";
+      boolean: "boolean";
+    }>;
+    description: z.ZodNullable<z.ZodString>;
+    required: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AppToolSummary = z.infer<typeof appToolSummarySchema>;
+export declare const appToolCallSchema: z.ZodObject<{
+  input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type AppToolCall = z.input<typeof appToolCallSchema>;
+export declare const appToolResultSchema: z.ZodObject<{
+  result: z.ZodUnknown;
+}, z.core.$strip>;
+export type AppToolResult = z.infer<typeof appToolResultSchema>;
+/** 설치 저장소(`ctx.storage`, 매뉴얼 「앱 코드 › 저장소」) — 설치 토큰 전용 */
+export declare const APP_STORAGE_KEY_PATTERN: RegExp;
+export declare const APP_STORAGE_MAX_KEYS = 1000;
+/** 설치당 전체 크기(키 + JSON 값, UTF-8 바이트) */
+export declare const APP_STORAGE_MAX_BYTES: number;
+export declare const appStorageEntrySchema: z.ZodObject<{
+  key: z.ZodString;
+  value: z.ZodUnknown;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AppStorageEntry = z.infer<typeof appStorageEntrySchema>;
+export declare const appStorageKeysSchema: z.ZodObject<{
+  keys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AppStorageKeys = z.infer<typeof appStorageKeysSchema>;
+export declare const appStoragePutSchema: z.ZodObject<{
+  value: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+}, z.core.$strip>;
+export type AppStoragePut = z.infer<typeof appStoragePutSchema>;
+export declare const appStorageListQuerySchema: z.ZodObject<{
+  prefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const developerOrgSchema: z.ZodObject<{
   orgId: z.ZodString;
   name: z.ZodString;
@@ -2830,6 +3178,8 @@ export declare const appVersionSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodString>;
     networkHosts: z.ZodArray<z.ZodString>;
     adminPage: z.ZodBoolean;
+    publicHttp: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    schedules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     requiredSettings: z.ZodArray<z.ZodString>;
     secretSettings: z.ZodArray<z.ZodString>;
   }, z.core.$strip>;
@@ -2867,6 +3217,26 @@ export declare const appVersionSchema: z.ZodObject<{
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type AppVersion = z.infer<typeof appVersionSchema>;
+/** 앱 공개 심사(#22, 매뉴얼 「앱 공개 범위」) — 개발자가 신청하고 운영자가 승인·반려한다 */
+export declare const appListingReviewStatusSchema: z.ZodEnum<{
+  PENDING: "PENDING";
+  REJECTED: "REJECTED";
+  APPROVED: "APPROVED";
+}>;
+export type AppListingReviewStatus = z.infer<typeof appListingReviewStatusSchema>;
+export declare const appListingReviewSchema: z.ZodObject<{
+  reviewId: z.ZodString;
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    REJECTED: "REJECTED";
+    APPROVED: "APPROVED";
+  }>;
+  versionNumber: z.ZodNumber;
+  reason: z.ZodNullable<z.ZodString>;
+  requestedAt: z.ZodString;
+  reviewedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AppListingReview = z.infer<typeof appListingReviewSchema>;
 export declare const developerAppSchema: z.ZodObject<{
   appId: z.ZodString;
   orgId: z.ZodString;
@@ -2891,6 +3261,19 @@ export declare const developerAppSchema: z.ZodObject<{
   }>;
   suspendedReason: z.ZodNullable<z.ZodString>;
   currentVersionNumber: z.ZodNullable<z.ZodNumber>;
+  privateStoreId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  listingReview: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+    reviewId: z.ZodString;
+    status: z.ZodEnum<{
+      PENDING: "PENDING";
+      REJECTED: "REJECTED";
+      APPROVED: "APPROVED";
+    }>;
+    versionNumber: z.ZodNumber;
+    reason: z.ZodNullable<z.ZodString>;
+    requestedAt: z.ZodString;
+    reviewedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
   installations: z.ZodObject<{
     active: z.ZodNumber;
     pendingReconsent: z.ZodNumber;
@@ -2903,6 +3286,7 @@ export declare const developerAppCreateSchema: z.ZodObject<{
   handle: z.ZodString;
   name: z.ZodString;
   description: z.ZodOptional<z.ZodString>;
+  privateStoreId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type DeveloperAppCreate = z.infer<typeof developerAppCreateSchema>;
 /** `PUT /platform/v1/developer/apps/{appId}/versions` — CLI `app deploy`가 올리는 번들 */
@@ -2945,6 +3329,8 @@ export declare const appReleaseResultSchema: z.ZodObject<{
       events: z.ZodArray<z.ZodString>;
       networkHosts: z.ZodArray<z.ZodString>;
       adminPage: z.ZodBoolean;
+      publicHttp: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      schedules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       requiredSettings: z.ZodArray<z.ZodString>;
       secretSettings: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
@@ -3002,6 +3388,17 @@ export declare const devStoreSchema: z.ZodObject<{
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type DevStore = z.infer<typeof devStoreSchema>;
+/** `GET /platform/v1/developer/stores` — 비공개 앱을 묶을 수 있는 상점(내가 소유자·관리자, 운영 중) */
+export declare const developerStoreSchema: z.ZodObject<{
+  storeId: z.ZodString;
+  name: z.ZodString;
+  role: z.ZodEnum<{
+    ADMIN: "ADMIN";
+    OWNER: "OWNER";
+  }>;
+  development: z.ZodBoolean;
+}, z.core.$strip>;
+export type DeveloperStore = z.infer<typeof developerStoreSchema>;
 /** 개발자가 보는 설치 한 줄 */
 export declare const developerInstallationSchema: z.ZodObject<{
   installationId: z.ZodString;
@@ -3034,8 +3431,10 @@ export declare const appInvocationSchema: z.ZodObject<{
   versionNumber: z.ZodNullable<z.ZodNumber>;
   kind: z.ZodEnum<{
     event: "event";
+    flow: "flow";
     http: "http";
     schedule: "schedule";
+    tool: "tool";
   }>;
   eventType: z.ZodNullable<z.ZodString>;
   outcome: z.ZodEnum<{
@@ -13292,9 +13691,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /**
      * `POST /order-items/{id}/events/{key}` — 현장 단말·연동의 상점 사건(`custom.<이름>`)을 플로우에 넣는다(#115).
-     * 에러: 400 `FLOW_EVENT_KEY_INVALID`, 409 `FLOW_EVENT_NOT_ACCEPTED`
+     * 앱 사건(`app.<handle>.<이름>`, #22)은 그 앱의 설치 토큰으로만 보낸다(`ctx.api`).
+     * 에러: 400 `FLOW_EVENT_KEY_INVALID`, 403 `FLOW_EVENT_APP_FORBIDDEN`, 409 `FLOW_EVENT_NOT_ACCEPTED`
      */
-    emitEvent: (orderItemId: string, key: `custom.${string}`, input?: Record<string, unknown>, idempotencyKey?: string) => Promise<{
+    emitEvent: (orderItemId: string, key: `custom.${string}` | `app.${string}`, input?: Record<string, unknown>, idempotencyKey?: string) => Promise<{
       status: "COMPLETED";
       flowState: {
         key: string;
@@ -15896,6 +16296,28 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
   };
   /** 설치 앱(#22, 매뉴얼 「앱 설치와 관리 › 관리 API」) — 설치·설정·제거·세션은 상점 플랫폼 OWNER·ADMIN만 */
+  /** 에이전트 도구(#22 「에이전트 도구」) — 설치된 앱이 제공하는 도구 목록·실행. 실행은 OWNER·ADMIN */
+  appTools: {
+    list: () => Promise<{
+      installationId: string;
+      app: {
+        appId: string;
+        handle: string;
+        name: string;
+      };
+      name: string;
+      description: string;
+      input: {
+        name: string;
+        type: "string" | "number" | "boolean";
+        description: string | null;
+        required: boolean;
+      }[];
+    }[]>;
+    call: (installationId: string, name: string, input?: Record<string, unknown>) => Promise<{
+      result: unknown;
+    }>;
+  };
   apps: {
     /** 이 상점에 설치할 수 있는 앱 — 앱 목록·상세(아이콘·README·Scope·Hook·설정 필드) */
     catalog: {
@@ -15908,6 +16330,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         developerName: string;
         versionNumber: number;
         installationId: string | null;
+        visibility: "PUBLIC" | "DEVELOPMENT" | "PRIVATE";
       }[]>;
       get: (appId: string) => Promise<{
         appId: string;
@@ -15918,11 +16341,22 @@ export declare function createStoreClient(options: StoreClientOptions): {
         developerName: string;
         versionNumber: number;
         installationId: string | null;
+        visibility: "PUBLIC" | "DEVELOPMENT" | "PRIVATE";
         readme: string | null;
         supportEmail: string | null;
         scopes: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         networkHosts: string[];
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
         settings: Record<string, {
           type: "string" | "number" | "boolean" | "select";
           label: string;
@@ -15967,6 +16401,30 @@ export declare function createStoreClient(options: StoreClientOptions): {
         grantedNetworkHosts: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
+        flowNotifications: {
+          name: string;
+          label: string;
+          params: {
+            name: string;
+            type: "string" | "number" | "boolean";
+            label: string;
+            required: boolean;
+          }[];
+        }[];
+        flowEvents: {
+          name: string;
+          label: string;
+        }[];
         settings: {
           fields: Record<string, {
             type: "string" | "number" | "boolean" | "select";
@@ -15996,6 +16454,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           scopes: string[];
           networkHosts: string[];
           events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          publicHttp: string[];
+          schedules: {
+            name: string;
+            every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+          }[];
+          tools: {
+            name: string;
+            description: string;
+          }[];
+          externalHost: string | null;
         } | null | undefined;
       }>;
       list: () => Promise<{
@@ -16020,6 +16488,30 @@ export declare function createStoreClient(options: StoreClientOptions): {
         grantedNetworkHosts: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
+        flowNotifications: {
+          name: string;
+          label: string;
+          params: {
+            name: string;
+            type: "string" | "number" | "boolean";
+            label: string;
+            required: boolean;
+          }[];
+        }[];
+        flowEvents: {
+          name: string;
+          label: string;
+        }[];
         settings: {
           fields: Record<string, {
             type: "string" | "number" | "boolean" | "select";
@@ -16049,6 +16541,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           scopes: string[];
           networkHosts: string[];
           events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          publicHttp: string[];
+          schedules: {
+            name: string;
+            every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+          }[];
+          tools: {
+            name: string;
+            description: string;
+          }[];
+          externalHost: string | null;
         } | null | undefined;
       }[]>;
       get: (installationId: string) => Promise<{
@@ -16073,6 +16575,30 @@ export declare function createStoreClient(options: StoreClientOptions): {
         grantedNetworkHosts: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
+        flowNotifications: {
+          name: string;
+          label: string;
+          params: {
+            name: string;
+            type: "string" | "number" | "boolean";
+            label: string;
+            required: boolean;
+          }[];
+        }[];
+        flowEvents: {
+          name: string;
+          label: string;
+        }[];
         settings: {
           fields: Record<string, {
             type: "string" | "number" | "boolean" | "select";
@@ -16102,6 +16628,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           scopes: string[];
           networkHosts: string[];
           events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          publicHttp: string[];
+          schedules: {
+            name: string;
+            every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+          }[];
+          tools: {
+            name: string;
+            description: string;
+          }[];
+          externalHost: string | null;
         } | null | undefined;
       }>;
       /** 비밀 필드를 생략하면 현재 값을 유지한다. null은 비운다 */
@@ -16127,6 +16663,30 @@ export declare function createStoreClient(options: StoreClientOptions): {
         grantedNetworkHosts: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
+        flowNotifications: {
+          name: string;
+          label: string;
+          params: {
+            name: string;
+            type: "string" | "number" | "boolean";
+            label: string;
+            required: boolean;
+          }[];
+        }[];
+        flowEvents: {
+          name: string;
+          label: string;
+        }[];
         settings: {
           fields: Record<string, {
             type: "string" | "number" | "boolean" | "select";
@@ -16156,6 +16716,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           scopes: string[];
           networkHosts: string[];
           events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          publicHttp: string[];
+          schedules: {
+            name: string;
+            every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+          }[];
+          tools: {
+            name: string;
+            description: string;
+          }[];
+          externalHost: string | null;
         } | null | undefined;
       }>;
       remove: (installationId: string) => Promise<void>;
@@ -16196,6 +16766,30 @@ export declare function createStoreClient(options: StoreClientOptions): {
         grantedNetworkHosts: string[];
         events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
+        publicHttp: string[];
+        schedules: {
+          name: string;
+          every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+        }[];
+        tools: {
+          name: string;
+          description: string;
+        }[];
+        externalHost: string | null;
+        flowNotifications: {
+          name: string;
+          label: string;
+          params: {
+            name: string;
+            type: "string" | "number" | "boolean";
+            label: string;
+            required: boolean;
+          }[];
+        }[];
+        flowEvents: {
+          name: string;
+          label: string;
+        }[];
         settings: {
           fields: Record<string, {
             type: "string" | "number" | "boolean" | "select";
@@ -16225,6 +16819,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           scopes: string[];
           networkHosts: string[];
           events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          publicHttp: string[];
+          schedules: {
+            name: string;
+            every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
+          }[];
+          tools: {
+            name: string;
+            description: string;
+          }[];
+          externalHost: string | null;
         } | null | undefined;
       }>;
       /** 앱 화면 iframe에 넘길 세션 토큰(5분) */
@@ -16246,6 +16850,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
       grantedScopes: string[];
       installedAt: string;
     }>;
+    /** 설치 저장소(`ctx.storage`) — 없는 키는 404 `APP_STORAGE_KEY_NOT_FOUND`, 한도 초과는 409 `APP_STORAGE_LIMIT` */
+    storage: {
+      list: (params?: {
+        prefix?: string;
+      }) => Promise<{
+        keys: string[];
+      }>;
+      get: (key: string) => Promise<{
+        key: string;
+        value: unknown;
+        updatedAt: string;
+      }>;
+      set: (key: string, value: unknown) => Promise<{
+        key: string;
+        value: unknown;
+        updatedAt: string;
+      }>;
+      delete: (key: string) => Promise<void>;
+    };
   };
   webhooks: {
     list: () => Promise<{