apps 0.0.1-beta.87 → 0.0.1-beta.88

package/js/{chunk-7NTL2NOR.js → chunk-3K3VA76C.js}

@@ -1,11 +1,11 @@
 import {
   fixedRouter
-} from "./chunk-2P7BTRWZ.js";
+} from "./chunk-EXARUCNH.js";
 import {
   nativeOperation,
   operationDeclaration,
   routerDeclaration
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 
 // src/implementation/protocol-operations.ts
 var protocolOperations = (operations, kinds = {}) => {

package/js/{chunk-JF6FO6YA.js → chunk-6YMYQSTQ.js}

@@ -6,7 +6,7 @@ import {
   RouterKey,
   RouterMeta,
   reservedRouterKeys
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   decoderOf,
   schemaArgument

package/js/{chunk-EZUX2YJS.js → chunk-EVTBFNHI.js}

@@ -12,7 +12,7 @@ import {
   parseSkillLoadFailed,
   readCatalog,
   routerSkills
-} from "./chunk-2P7BTRWZ.js";
+} from "./chunk-EXARUCNH.js";
 import {
   appInvocationFetch
 } from "./chunk-I6Q7ZPKJ.js";
@@ -26,12 +26,12 @@ import {
   makeEmitter,
   toEffectApp,
   withPlacements
-} from "./chunk-OEZI25CT.js";
+} from "./chunk-FIVMUILF.js";
 import {
   declaredOperations,
   locate,
   nativeOperation
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   accountProviderError,
   appCode,
@@ -91,7 +91,7 @@ import {
   reservedTablePrefix,
   sqlBindingsLimit,
   workflowDurationMillis
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   AppSkills,
   SkillFile
@@ -1153,7 +1153,7 @@ function providerDeclaration(provider) {
     `Account provider "${provider.name}" has an invalid declaration`
   );
 }
-function requirements(slots, sql, events) {
+function requirements(slots, sql, events, icons) {
   return Effect_exports.gen(function* () {
     const accounts = /* @__PURE__ */ new Map();
     for (const [slot, selection] of Object.entries(slots)) {
@@ -1173,7 +1173,8 @@ function requirements(slots, sql, events) {
           () => declaredEvents(events),
           "The app's event declarations are invalid"
         )
-      }
+      },
+      ...icons === void 0 ? {} : { icons }
     }).pipe(
       Effect_exports.mapError(
         (cause) => declarationInvalid("The app's account declarations are invalid", cause)
@@ -1293,7 +1294,7 @@ function dispatch(app, request, context, signal, emitted) {
       const native = toEffectApp(app);
       const secrets = accountSecrets(context.accounts);
       const ownsSql = hasMigrations(context.files ?? []);
-      const declared = yield* requirements(native.accounts, ownsSql, native.events);
+      const declared = yield* requirements(native.accounts, ownsSql, native.events, native.icons);
       if (request.operation === "requirements")
         return yield* safe2(
           () => Schema_exports.decodeUnknownEffect(JsonValue)(declared),

package/js/{chunk-2P7BTRWZ.js → chunk-EXARUCNH.js}

@@ -4,7 +4,7 @@ import {
 import {
   joinPath,
   mergeMeta
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   isShortenedUpstream,
   parseProviderError,
@@ -21,7 +21,7 @@ import {
   McpError,
   McpError2,
   SkillLoadFailed as SkillLoadFailed2
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   CacheError,
   FailureCode,

package/js/{chunk-OEZI25CT.js → chunk-FIVMUILF.js}

@@ -2,7 +2,7 @@ import {
   declaredOperations,
   nativeOperation,
   nativeRouter
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   fromPromise,
   method
@@ -12,11 +12,12 @@ import {
   EventName,
   Placement,
   ScheduleTiming,
+  appIconsProblem,
   defaultEventLimits,
   normalizePlacements,
   placementFields,
   renderPlacement
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   decoderOf,
   isSchema,
@@ -393,9 +394,13 @@ var defineApp = (requirements, definition) => {
       return [name, native2];
     })
   );
+  const iconsProblem = requirements.icons === void 0 ? void 0 : appIconsProblem(requirements.icons);
+  if (iconsProblem !== void 0)
+    throw new TypeError(`The app's icons are invalid: ${iconsProblem}`);
   const native = {
     accounts: requirements.accounts,
     ...events === void 0 ? {} : { events },
+    ...requirements.icons === void 0 || requirements.icons.length === 0 ? {} : { icons: requirements.icons },
     evaluate: (context) => factory(context).pipe(Effect_exports.map((value2) => adaptDefinition(value2)))
   };
   return {

package/js/{chunk-7R73XVF3.js → chunk-Q4WQMUEO.js}

@@ -1,6 +1,6 @@
 import {
   prepareElicitation
-} from "./chunk-EZUX2YJS.js";
+} from "./chunk-EVTBFNHI.js";
 import {
   failOnNetworkRefusal
 } from "./chunk-I6Q7ZPKJ.js";
@@ -26,7 +26,7 @@ import {
   defaultMcpClientLimits,
   mcpHealthReserveMs,
   mcpSdkTimerCeilingMs
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   NetworkRefused,
   ProviderError

package/js/{chunk-WUPLD4VN.js → chunk-S22ADZID.js}

@@ -2100,6 +2100,37 @@ var EmittedEvents = Schema_exports.Array(EmittedEvent).check(
   Schema_exports.isMaxLength(defaultEventLimits.maxEventsPerInvocation)
 );
 
+// src/contracts/icons.ts
+var appIconLimits = { icons: 8, characters: 32 * 1024 };
+var appIconSource = /^(?:data:image\/(?:svg\+xml|png|webp|jpeg);base64,[A-Za-z0-9+/]*={0,2}|https:\/\/\S+)$/u;
+var AppIcon = Schema_exports.Struct({
+  ...RouterIcon.fields,
+  src: Schema_exports.String.check(
+    Schema_exports.isPattern(appIconSource),
+    Schema_exports.isMaxLength(appIconLimits.characters)
+  )
+});
+var AppIcons = Schema_exports.Array(AppIcon).check(
+  Schema_exports.isMaxLength(appIconLimits.icons),
+  Schema_exports.makeFilter((icons) => JSON.stringify(icons).length <= appIconLimits.characters, {
+    message: `An app's icons total at most ${appIconLimits.characters} characters`
+  })
+);
+var appIconsProblem = (icons) => {
+  if (!Array.isArray(icons)) return "icons must be an array of { src, mimeType?, sizes?, theme? }";
+  if (icons.length > appIconLimits.icons)
+    return `An app declares at most ${appIconLimits.icons} icons; this one declares ${icons.length}`;
+  for (const [index, icon] of icons.entries()) {
+    const src = typeof icon === "object" && icon !== null ? icon.src : void 0;
+    if (typeof src !== "string" || !appIconSource.test(src))
+      return `icons[${index}].src must be a base64 data:image/svg+xml, image/png, image/webp or image/jpeg URI, or an https: URL`;
+  }
+  const size = JSON.stringify(icons).length;
+  if (size > appIconLimits.characters)
+    return `An app's icons total at most 32 KiB; these take ${Math.ceil(size / 1024)} KiB`;
+  return Schema_exports.is(AppIcons)(icons) ? void 0 : 'Each icon is { src, mimeType?: string, sizes?: string[], theme?: "light" | "dark" }';
+};
+
 // src/contracts/placement.ts
 var PlacementField = Schema_exports.Struct({ field: Schema_exports.NonEmptyString });
 var PlacementText = Schema_exports.Union([Schema_exports.String, PlacementField]);
@@ -4007,7 +4038,9 @@ var DeclaredRequirements6 = Schema_exports.Struct({
   /** The build has SQL files in `migrations/` and owns a raw SQLite database. */
   sql: Schema_exports.optionalKey(Schema_exports.Literal(true)),
   /** The events the app declares, so a host lists them without evaluating the app. */
-  events: Schema_exports.optionalKey(DeclaredEvents)
+  events: Schema_exports.optionalKey(DeclaredEvents),
+  /** The icons the app declares, so a host shows them without evaluating the app. */
+  icons: Schema_exports.optionalKey(AppIcons)
 });
 var ResolvedAccount4 = Schema_exports.Struct({
   id: AccountId,
@@ -4436,6 +4469,10 @@ export {
   DeclaredEvents,
   EmittedEvent,
   EmittedEvents,
+  appIconLimits,
+  AppIcon,
+  AppIcons,
+  appIconsProblem,
   frameworkProtocol,
   protocol1,
   protocol2,

package/js/contracts.js

@@ -3,6 +3,8 @@ import {
   AccountCheckResult,
   AccountInfo,
   ApiErrorResponse,
+  AppIcon,
+  AppIcons,
   ApprovalElicitation,
   ApprovalResponse,
   CalendarSchedule,
@@ -113,6 +115,7 @@ import {
   WorkflowRunPage,
   WorkflowStepOptions,
   WorkflowValue,
+  appIconLimits,
   approvalElicitation,
   current,
   defaultElicitationLimits,
@@ -146,7 +149,7 @@ import {
   skillCatalog,
   skillsCommand,
   workflowDurationMillis
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   FailureCode,
   FailureDetail,
@@ -197,6 +200,8 @@ export {
   AccountId,
   AccountInfo,
   ApiErrorResponse,
+  AppIcon,
+  AppIcons,
   AppSkillMetadata,
   AppSkillName,
   AppSkillSource,
@@ -330,6 +335,7 @@ export {
   WorkflowRunPage,
   WorkflowStepOptions,
   WorkflowValue,
+  appIconLimits,
   approvalElicitation,
   defaultElicitationLimits,
   defaultEventLimits,

package/js/effect.js

@@ -3,17 +3,17 @@ import {
   ApprovalDecision,
   createAppHandler,
   prepareElicitation
-} from "./chunk-EZUX2YJS.js";
+} from "./chunk-EVTBFNHI.js";
 import "./chunk-XBHWCCNB.js";
-import "./chunk-2P7BTRWZ.js";
+import "./chunk-EXARUCNH.js";
 import "./chunk-I6Q7ZPKJ.js";
 import "./chunk-XBG7HHXC.js";
-import "./chunk-OEZI25CT.js";
-import "./chunk-JF6FO6YA.js";
+import "./chunk-FIVMUILF.js";
+import "./chunk-6YMYQSTQ.js";
 import "./chunk-W6XCQAXP.js";
 import {
   ToolAnnotations
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import "./chunk-Q4IZAUIF.js";
 import "./chunk-H72MEDMN.js";
 import {

package/js/graphql.js

@@ -4,28 +4,28 @@ import {
 } from "./chunk-FVYCYTYL.js";
 import {
   protocolOperations
-} from "./chunk-7NTL2NOR.js";
+} from "./chunk-3K3VA76C.js";
 import "./chunk-BCSNKUAC.js";
-import "./chunk-EZUX2YJS.js";
+import "./chunk-EVTBFNHI.js";
 import {
   cacheKey
 } from "./chunk-XBHWCCNB.js";
-import "./chunk-2P7BTRWZ.js";
+import "./chunk-EXARUCNH.js";
 import {
   failOnNetworkRefusal
 } from "./chunk-I6Q7ZPKJ.js";
 import "./chunk-XBG7HHXC.js";
-import "./chunk-OEZI25CT.js";
+import "./chunk-FIVMUILF.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   accountProviderError,
   graphqlProviderError,
   httpProviderError
 } from "./chunk-W6XCQAXP.js";
-import "./chunk-WUPLD4VN.js";
+import "./chunk-S22ADZID.js";
 import {
   NetworkRefused,
   ProviderError

package/js/host.js

@@ -1,12 +1,12 @@
 import {
   createAppHandler
-} from "./chunk-EZUX2YJS.js";
+} from "./chunk-EVTBFNHI.js";
 import "./chunk-XBHWCCNB.js";
-import "./chunk-2P7BTRWZ.js";
+import "./chunk-EXARUCNH.js";
 import "./chunk-I6Q7ZPKJ.js";
 import "./chunk-XBG7HHXC.js";
-import "./chunk-OEZI25CT.js";
-import "./chunk-JF6FO6YA.js";
+import "./chunk-FIVMUILF.js";
+import "./chunk-6YMYQSTQ.js";
 import "./chunk-W6XCQAXP.js";
 import {
   ElicitationFailed,
@@ -22,7 +22,7 @@ import {
   WorkflowRun,
   WorkflowRunId,
   WorkflowRunPage
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   CacheCommand,
   CacheError,

package/js/index.js

@@ -11,7 +11,7 @@ import {
   query,
   t,
   workflow
-} from "./chunk-OEZI25CT.js";
+} from "./chunk-FIVMUILF.js";
 import {
   dynamicRouter,
   mutation,
@@ -25,7 +25,7 @@ import {
   toolAnnotations,
   withApproval,
   withApprovals
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   accountProviderError,
   fromPromise
@@ -44,7 +44,7 @@ import {
   ScheduleTiming,
   SecretsMethod,
   WorkflowFailure
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   CacheError,
   FetchOptionUnsupported,

package/js/mcp/effect.js

@@ -2,17 +2,17 @@ import {
   mcpClientEffect,
   mcpHealthEffect,
   mcpToolsEffect
-} from "../chunk-7R73XVF3.js";
+} from "../chunk-Q4WQMUEO.js";
 import "../chunk-BCSNKUAC.js";
-import "../chunk-EZUX2YJS.js";
+import "../chunk-EVTBFNHI.js";
 import "../chunk-XBHWCCNB.js";
-import "../chunk-2P7BTRWZ.js";
+import "../chunk-EXARUCNH.js";
 import "../chunk-I6Q7ZPKJ.js";
 import "../chunk-XBG7HHXC.js";
-import "../chunk-OEZI25CT.js";
-import "../chunk-JF6FO6YA.js";
+import "../chunk-FIVMUILF.js";
+import "../chunk-6YMYQSTQ.js";
 import "../chunk-W6XCQAXP.js";
-import "../chunk-WUPLD4VN.js";
+import "../chunk-S22ADZID.js";
 import "../chunk-Q4IZAUIF.js";
 import "../chunk-H72MEDMN.js";
 import "../chunk-A3HPRNJC.js";

package/js/mcp.js

@@ -4,27 +4,27 @@ import {
 } from "./chunk-FVYCYTYL.js";
 import {
   protocolOperations
-} from "./chunk-7NTL2NOR.js";
+} from "./chunk-3K3VA76C.js";
 import {
   adaptMcpTool,
   mcpClientEffect,
   mcpHealthEffect
-} from "./chunk-7R73XVF3.js";
+} from "./chunk-Q4WQMUEO.js";
 import "./chunk-BCSNKUAC.js";
-import "./chunk-EZUX2YJS.js";
+import "./chunk-EVTBFNHI.js";
 import {
   cacheKey
 } from "./chunk-XBHWCCNB.js";
 import {
   operationDescription
-} from "./chunk-2P7BTRWZ.js";
+} from "./chunk-EXARUCNH.js";
 import "./chunk-I6Q7ZPKJ.js";
 import "./chunk-XBG7HHXC.js";
-import "./chunk-OEZI25CT.js";
+import "./chunk-FIVMUILF.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   fromPromise,
   method
@@ -35,7 +35,7 @@ import {
   McpServerHeader,
   McpToolMetadata,
   McpToolsOptions
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import "./chunk-Q4IZAUIF.js";
 import "./chunk-H72MEDMN.js";
 import "./chunk-A3HPRNJC.js";

package/js/openapi.js

@@ -8,7 +8,7 @@ import {
 import {
   protocolOperations,
   protocolRouter
-} from "./chunk-7NTL2NOR.js";
+} from "./chunk-3K3VA76C.js";
 import {
   OpenapiCompileError,
   OpenapiCompileErrorCode,
@@ -29,7 +29,7 @@ import {
   isOpenapiTextMedia,
   openapiBinaryResultSchema,
   openapiMediaKind
-} from "./chunk-2P7BTRWZ.js";
+} from "./chunk-EXARUCNH.js";
 import {
   failOnNetworkRefusal
 } from "./chunk-I6Q7ZPKJ.js";
@@ -37,7 +37,7 @@ import "./chunk-XBG7HHXC.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-JF6FO6YA.js";
+} from "./chunk-6YMYQSTQ.js";
 import {
   accountProviderError,
   bodyUpstreamError,
@@ -53,7 +53,7 @@ import {
   OpenapiResponseError,
   RouterMeta,
   defaultOpenapiErrorLimits
-} from "./chunk-WUPLD4VN.js";
+} from "./chunk-S22ADZID.js";
 import {
   NetworkRefused,
   ProviderError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apps",
-  "version": "0.0.1-beta.87",
+  "version": "0.0.1-beta.88",
   "description": "TypeScript apps with typed tools, accounts, storage, and UI.",
   "type": "module",
   "sideEffects": false,