@on-mission/sdk 0.1.3 → 0.1.4

package/dist/auth-failure-tracker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Auth Failure Tracker
+ *
+ * Tracks consecutive UNAUTHORIZED responses across all authenticated
+ * SDK operations (heartbeat, token refresh, log flush). After a
+ * configurable threshold of consecutive failures, fires a callback
+ * that the SDK uses to self-terminate via process.exit(1).
+ *
+ * This triggers Daytona's sandbox restart webhook, which runs the
+ * existing sandboxRestartWorkflow to re-provision the skill with
+ * a fresh JWT.
+ *
+ * Any successful authenticated call resets the counter to zero.
+ */
+export declare const AUTH_FAILURE_THRESHOLD = 3;
+export type AuthFailureTracker = {
+    recordFailure: () => void;
+    recordSuccess: () => void;
+    getFailureCount: () => number;
+};
+export declare const createAuthFailureTracker: (onThresholdReached: () => void) => AuthFailureTracker;
+//# sourceMappingURL=auth-failure-tracker.d.ts.map

package/dist/auth-failure-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-failure-tracker.d.ts","sourceRoot":"","sources":["../src/auth-failure-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,MAAM,CAAA;CAC9B,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,oBAAoB,MAAM,IAAI,KAC7B,kBAeF,CAAA"}

package/dist/auth-failure-tracker.js

@@ -0,0 +1,31 @@
+/**
+ * Auth Failure Tracker
+ *
+ * Tracks consecutive UNAUTHORIZED responses across all authenticated
+ * SDK operations (heartbeat, token refresh, log flush). After a
+ * configurable threshold of consecutive failures, fires a callback
+ * that the SDK uses to self-terminate via process.exit(1).
+ *
+ * This triggers Daytona's sandbox restart webhook, which runs the
+ * existing sandboxRestartWorkflow to re-provision the skill with
+ * a fresh JWT.
+ *
+ * Any successful authenticated call resets the counter to zero.
+ */
+export const AUTH_FAILURE_THRESHOLD = 3;
+export const createAuthFailureTracker = (onThresholdReached) => {
+    const state = { consecutiveFailures: 0 };
+    return {
+        recordFailure: () => {
+            state.consecutiveFailures += 1;
+            if (state.consecutiveFailures >= AUTH_FAILURE_THRESHOLD) {
+                onThresholdReached();
+            }
+        },
+        recordSuccess: () => {
+            state.consecutiveFailures = 0;
+        },
+        getFailureCount: () => state.consecutiveFailures
+    };
+};
+//# sourceMappingURL=auth-failure-tracker.js.map

package/dist/auth-failure-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-failure-tracker.js","sourceRoot":"","sources":["../src/auth-failure-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAQvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,kBAA8B,EACV,EAAE;IACtB,MAAM,KAAK,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAA;IAExC,OAAO;QACL,aAAa,EAAE,GAAG,EAAE;YAClB,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,mBAAmB,IAAI,sBAAsB,EAAE,CAAC;gBACxD,kBAAkB,EAAE,CAAA;YACtB,CAAC;QACH,CAAC;QACD,aAAa,EAAE,GAAG,EAAE;YAClB,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAA;QAC/B,CAAC;QACD,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB;KACjD,CAAA;AACH,CAAC,CAAA"}

package/dist/auth.d.ts

@@ -9,7 +9,7 @@
  * Skill authors always call `auth.get()` regardless of auth type.
  *
  * For managed auth (Nango-backed), the SDK caches tokens and refreshes
- * transparently. See docs/technical-designs/managed-auth-nango.md.
+ * transparently. See docs/technical/architecture/skills/authentication.md.
  *
  * For custom auth, credentials are collected via a connection form
  * defined in mission.json's `auth.credentials` schema.

package/dist/auth.js

@@ -9,7 +9,7 @@
  * Skill authors always call `auth.get()` regardless of auth type.
  *
  * For managed auth (Nango-backed), the SDK caches tokens and refreshes
- * transparently. See docs/technical-designs/managed-auth-nango.md.
+ * transparently. See docs/technical/architecture/skills/authentication.md.
  *
  * For custom auth, credentials are collected via a connection form
  * defined in mission.json's `auth.credentials` schema.

package/dist/config.d.ts

@@ -5,7 +5,7 @@
  * Accepts optional defaults so skills always get a complete config
  * object without manual merging.
  *
- * The control plane stores config per AppConnection. Values are set
+ * The control plane stores config per Connection. Values are set
  * by the user in the App's settings UI (defined by configSchema in
  * mission.json). The SDK merges platform values over provided defaults
  * so the returned object is always complete.

package/dist/config.js

@@ -5,7 +5,7 @@
  * Accepts optional defaults so skills always get a complete config
  * object without manual merging.
  *
- * The control plane stores config per AppConnection. Values are set
+ * The control plane stores config per Connection. Values are set
  * by the user in the App's settings UI (defined by configSchema in
  * mission.json). The SDK merges platform values over provided defaults
  * so the returned object is always complete.

package/dist/context.d.ts

@@ -4,7 +4,7 @@
  * Bootstrapped from environment variables injected by the Mission control plane
  * when it starts the skill process inside the Daytona sandbox.
  *
- * See docs/technical-designs/skill-architecture.md §4.5.
+ * See docs/technical/architecture/skills/architecture.md §4.5.
  */
 export type SkillContext = {
     /** Mission control plane API base URL. */

package/dist/context.js

@@ -4,7 +4,7 @@
  * Bootstrapped from environment variables injected by the Mission control plane
  * when it starts the skill process inside the Daytona sandbox.
  *
- * See docs/technical-designs/skill-architecture.md §4.5.
+ * See docs/technical/architecture/skills/architecture.md §4.5.
  */
 /**
  * Read skill context from process environment variables.

package/dist/event-handler.d.ts

@@ -0,0 +1,16 @@
+export type SkillEvent = {
+    eventType: string;
+    payload: Record<string, unknown>;
+    platform: string;
+    tenantId: string;
+};
+export type EventHandler = (event: SkillEvent) => Promise<void> | void;
+export type EventHandlerRegistry = {
+    on: (eventName: string, handler: EventHandler) => void;
+    dispatch: (event: SkillEvent) => Promise<{
+        handled: boolean;
+    }>;
+    hasHandlers: () => boolean;
+};
+export declare const createEventHandlerRegistry: () => EventHandlerRegistry;
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../src/event-handler.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEtE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;IACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC9D,WAAW,EAAE,MAAM,OAAO,CAAA;CAC3B,CAAA;AAED,eAAO,MAAM,0BAA0B,QAAO,oBAgC7C,CAAA"}

package/dist/event-handler.js

@@ -0,0 +1,27 @@
+export const createEventHandlerRegistry = () => {
+    const handlers = new Map();
+    return {
+        on: (eventName, handler) => {
+            const existing = handlers.get(eventName) ?? [];
+            handlers.set(eventName, [...existing, handler]);
+        },
+        dispatch: async (event) => {
+            const specific = handlers.get(event.eventType) ?? [];
+            const wildcard = handlers.get('*') ?? [];
+            const all = [...specific, ...wildcard];
+            if (all.length === 0)
+                return { handled: false };
+            for (const handler of all) {
+                try {
+                    await handler(event);
+                }
+                catch (error) {
+                    console.error(`[Events] Handler for '${event.eventType}' failed:`, error);
+                }
+            }
+            return { handled: true };
+        },
+        hasHandlers: () => handlers.size > 0
+    };
+};
+//# sourceMappingURL=event-handler.js.map

package/dist/event-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.js","sourceRoot":"","sources":["../src/event-handler.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAyB,EAAE;IACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAElD,OAAO;QACL,EAAE,EAAE,CAAC,SAAiB,EAAE,OAAqB,EAAQ,EAAE;YACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;YAC9C,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,CAAC;QAED,QAAQ,EAAE,KAAK,EAAE,KAAiB,EAAiC,EAAE;YACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;YACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YACxC,MAAM,GAAG,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAA;YAEtC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;YAE/C,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CACX,yBAAyB,KAAK,CAAC,SAAS,WAAW,EACnD,KAAK,CACN,CAAA;gBACH,CAAC;YACH,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC1B,CAAC;QAED,WAAW,EAAE,GAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;KAC9C,CAAA;AACH,CAAC,CAAA"}

package/dist/http-server.d.ts

@@ -17,8 +17,8 @@
  * Skill authors never interact with it directly — they register tool handlers
  * and ingress handlers through the SDK, and this server routes to them.
  *
- * See docs/technical-designs/skill-architecture.md §4.1.
- * See docs/technical-designs/daytona-sandbox-runtime.md §2-3.
+ * See docs/technical/architecture/skills/architecture.md §4.1.
+ * See docs/technical/architecture/skills/sandbox-runtime.md §2-3.
  */
 import * as http from 'node:http';
 export type RouteHandler = (req: ParsedRequest) => Promise<{

package/dist/http-server.js

@@ -17,8 +17,8 @@
  * Skill authors never interact with it directly — they register tool handlers
  * and ingress handlers through the SDK, and this server routes to them.
  *
- * See docs/technical-designs/skill-architecture.md §4.1.
- * See docs/technical-designs/daytona-sandbox-runtime.md §2-3.
+ * See docs/technical/architecture/skills/architecture.md §4.1.
+ * See docs/technical/architecture/skills/sandbox-runtime.md §2-3.
  */
 import * as http from 'node:http';
 // ─── Helpers ─────────────────────────────────────────────────────────────────

package/dist/index.d.ts

@@ -5,18 +5,37 @@
  * Communication is HTTP-native: outbound REST calls to the Mission API,
  * inbound HTTP requests via Daytona Preview URLs.
  *
- * See docs/technical-designs/skill-architecture.md.
- * See docs/technical-designs/daytona-sandbox-runtime.md.
+ * See docs/technical/architecture/skills/architecture.md.
+ * See docs/technical/architecture/skills/sandbox-runtime.md.
  */
 export type { Tool, ToolFunction, ToolFunctionPermission, ToolKind } from '@mission/models';
 export type { ApiClient } from './api';
 export type { AuthCredentials, AuthModule, OAuthCredentials } from './auth';
 export type { ConfigModule } from './config';
 export type { SkillContext } from './context';
-export type { AgentMessage, EventsModule } from './events';
+export type { EventHandler, EventHandlerRegistry, SkillEvent } from './event-handler';
 export type { IngressHandler, IngressModule, IngressRequest, IngressResponse, IngressStreamEvents, IngressUrl } from './ingress';
 export type { LogModule } from './logging';
-export type { MissionSDK, MissionSDKOptions } from './sdk';
+export type { AgentMessage, MissionSDK, MissionSDKOptions } from './sdk';
 export { createMissionSDK } from './sdk';
-export type { ToolHandler, ToolsModule } from './tool-registry';
+export type { ToolCallContext, ToolCallEnvelope, ToolCallInput, ToolHandler, ToolsModule } from './tool-registry';
+/** Incoming webhook request passed to a skill's `webhook()` handler. */
+export type WebhookRequest = {
+    body: unknown;
+    headers: Record<string, string>;
+};
+/** Optional response a `webhook()` handler can return to the external service. */
+export type WebhookResponse = {
+    status: number;
+    body: unknown;
+};
+/**
+ * Result of a skill's `webhook()` handler.
+ * - `externalId`: tenant identifier used to route the event to the correct connection(s).
+ * - `response`: optional custom HTTP response to send back to the caller.
+ */
+export type WebhookResult = {
+    externalId: string | null;
+    response?: WebhookResponse;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACT,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC1D,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,UAAU,EACX,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACT,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACX,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,UAAU,EACX,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AACxC,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACZ,MAAM,iBAAiB,CAAA;AAIxB,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B,CAAA"}

package/dist/index.js

@@ -5,8 +5,8 @@
  * Communication is HTTP-native: outbound REST calls to the Mission API,
  * inbound HTTP requests via Daytona Preview URLs.
  *
- * See docs/technical-designs/skill-architecture.md.
- * See docs/technical-designs/daytona-sandbox-runtime.md.
+ * See docs/technical/architecture/skills/architecture.md.
+ * See docs/technical/architecture/skills/sandbox-runtime.md.
  */
 export { createMissionSDK } from './sdk.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA"}

package/dist/ingress.d.ts

@@ -26,8 +26,8 @@
  * There is no need to pre-declare them in mission.json — the SDK registers
  * them dynamically and reports them to the control plane at ready().
  *
- * See docs/technical-designs/skill-architecture.md §4.4.
- * See docs/technical-designs/daytona-sandbox-runtime.md §2-3.
+ * See docs/technical/architecture/skills/architecture.md §4.4.
+ * See docs/technical/architecture/skills/sandbox-runtime.md §2-3.
  */
 import type { ApiClient } from './api';
 export type IngressRequest = {

package/dist/ingress.js

@@ -26,8 +26,8 @@
  * There is no need to pre-declare them in mission.json — the SDK registers
  * them dynamically and reports them to the control plane at ready().
  *
- * See docs/technical-designs/skill-architecture.md §4.4.
- * See docs/technical-designs/daytona-sandbox-runtime.md §2-3.
+ * See docs/technical/architecture/skills/architecture.md §4.4.
+ * See docs/technical/architecture/skills/sandbox-runtime.md §2-3.
  */
 // ─── Factory ─────────────────────────────────────────────────────────────────
 export function createIngressRegistry(api) {

package/dist/logging.d.ts

@@ -18,6 +18,7 @@
  * Transport: skill.ingestLogs tRPC mutation (batched, fire-and-forget).
  */
 import type { ApiClient } from './api';
+import type { AuthFailureTracker } from './auth-failure-tracker';
 type LogLevel = 'log' | 'error' | 'warn' | 'info' | 'debug';
 export type LogEntry = {
     level: LogLevel;
@@ -42,7 +43,7 @@ export type LogModule = {
  * After this call, all console.log/error/warn/info/debug calls will
  * be intercepted, enriched with metadata, and batched for shipping.
  */
-export declare function installLogging(api: ApiClient): void;
+export declare function installLogging(api: ApiClient, tracker?: AuthFailureTracker): void;
 /**
  * Create a structured log module.
  *

package/dist/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,KAAK,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3D,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACjE,CAAA;AA6DD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAiDnD;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,SAAS,CA4B3C;AAID;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAIhE,KAAK,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3D,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACjE,CAAA;AAmED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI,CAkDN;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,SAAS,CA4B3C;AAID;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD"}

package/dist/logging.js

@@ -17,6 +17,7 @@
  *
  * Transport: skill.ingestLogs tRPC mutation (batched, fire-and-forget).
  */
+import { TRPCClientError } from '@trpc/client';
 // ─── Constants ───────────────────────────────────────────────────────────────
 /** How often to flush the log buffer (ms). */
 const FLUSH_INTERVAL_MS = 5_000;
@@ -26,6 +27,7 @@ const FLUSH_THRESHOLD = 50;
 let buffer = [];
 let flushTimer = null;
 let apiRef = null;
+let trackerRef = null;
 let originalConsole = null;
 function getOriginal() {
     // Return saved originals if we've installed console override,
@@ -51,9 +53,14 @@ async function flush() {
     buffer = [];
     try {
         await apiRef.trpc.skill.ingestLogs.mutate({ entries });
+        trackerRef?.recordSuccess();
     }
     catch (err) {
         getOriginal().error('[Logging] Flush failed:', err);
+        if (err instanceof TRPCClientError && err.data?.code === 'UNAUTHORIZED') {
+            trackerRef?.recordFailure();
+            return; // Don't re-enqueue — they'd fail again with the same error
+        }
         // Re-enqueue failed entries (drop if buffer is huge to avoid OOM)
         if (buffer.length < 500) {
             buffer.unshift(...entries);
@@ -68,8 +75,9 @@ async function flush() {
  * After this call, all console.log/error/warn/info/debug calls will
  * be intercepted, enriched with metadata, and batched for shipping.
  */
-export function installLogging(api) {
+export function installLogging(api, tracker) {
     apiRef = api;
+    trackerRef = tracker ?? null;
     // Preserve original console methods
     originalConsole = {
         log: console.log.bind(console),

package/dist/logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AA8B9C,gFAAgF;AAEhF,8CAA8C;AAC9C,MAAM,iBAAiB,GAAG,KAAK,CAAA;AAE/B,oDAAoD;AACpD,MAAM,eAAe,GAAG,EAAE,CAAA;AAE1B,gFAAgF;AAEhF,IAAI,MAAM,GAAe,EAAE,CAAA;AAC3B,IAAI,UAAU,GAA0C,IAAI,CAAA;AAC5D,IAAI,MAAM,GAAqB,IAAI,CAAA;AACnC,IAAI,UAAU,GAA8B,IAAI,CAAA;AAChD,IAAI,eAAe,GAA2B,IAAI,CAAA;AAElD,SAAS,WAAW;IAClB,8DAA8D;IAC9D,sDAAsD;IACtD,OAAO,CACL,eAAe,IAAI;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;KACnC,CACF,CAAA;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAe;IAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClB,IAAI,MAAM,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,KAAK,KAAK,EAAE,CAAA;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,KAAK;IAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM;QAAE,OAAM;IAE1C,MAAM,OAAO,GAAG,MAAM,CAAA;IACtB,MAAM,GAAG,EAAE,CAAA;IAEX,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;QACtD,UAAU,EAAE,aAAa,EAAE,CAAA;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,WAAW,EAAE,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAA;QACnD,IAAI,GAAG,YAAY,eAAe,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,cAAc,EAAE,CAAC;YACxE,UAAU,EAAE,aAAa,EAAE,CAAA;YAC3B,OAAM,CAAC,2DAA2D;QACpE,CAAC;QACD,kEAAkE;QAClE,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAc,EACd,OAA4B;IAE5B,MAAM,GAAG,GAAG,CAAA;IACZ,UAAU,GAAG,OAAO,IAAI,IAAI,CAAA;IAE5B,oCAAoC;IACpC,eAAe,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;KACnC,CAAA;IAED,MAAM,MAAM,GAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAEpE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACtC,wDAAwD;YACxD,eAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;YAEhC,wBAAwB;YACxB,MAAM,OAAO,GAAG,IAAI;iBACjB,GAAG,CAAC,GAAG,CAAC,EAAE;gBACT,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,GAAG,CAAA;gBACvC,IAAI,GAAG,YAAY,KAAK;oBAAE,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAA;gBAC9D,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,CAAC,CAAA;YAEZ,kCAAkC;YAClC,OAAO,CAAC;gBACN,KAAK;gBACL,OAAO;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC;IAED,wBAAwB;IACxB,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,KAAK,KAAK,EAAE,CAAA;IACd,CAAC,EAAE,iBAAiB,CAAC,CAAA;IAErB,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,CACV,KAAe,EACf,OAAe,EACf,IAA8B,EACxB,EAAE;QACR,sDAAsD;QACtD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAA;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QACxD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QAClD,CAAC;QAED,OAAO,CAAC;YACN,KAAK;YACL,OAAO;YACP,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,IAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACpD,IAAI,EAAE,CAAC,OAAO,EAAE,IAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACpD,KAAK,EAAE,CAAC,OAAO,EAAE,IAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;QACtD,KAAK,EAAE,CAAC,OAAO,EAAE,IAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;KACvD,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,UAAU,EAAE,CAAC;QACf,aAAa,CAAC,UAAU,CAAC,CAAA;QACzB,UAAU,GAAG,IAAI,CAAA;IACnB,CAAC;IACD,MAAM,KAAK,EAAE,CAAA;AACf,CAAC"}

package/dist/sdk.d.ts

@@ -14,19 +14,20 @@
  * Lifecycle:
  *   1. const mission = createMissionSDK()     — create SDK (no connection yet)
  *   2. await mission.connect()                — start HTTP server, install logging
- *   3. // auth, config, events are now usable
+ *   3. // auth, config are now usable
  *   4. mission.tools.registerAll(handlers)    — register tool handlers
  *   5. mission.ingress.on('name', handler)    — register ingress handlers
- *   6. mission.onShutdown(() => cleanup())    — register shutdown hooks
- *   7. await mission.ready()                  — signal readiness, accept traffic
+ *   6. mission.on('event_type', handler)      — register event handler
+ *   7. mission.onShutdown(() => cleanup())    — register shutdown hooks
+ *   8. await mission.ready()                  — signal readiness, accept traffic
  *
- * See docs/technical-designs/skill-architecture.md §4 and §6.
- * See docs/technical-designs/daytona-sandbox-runtime.md.
+ * See docs/technical/architecture/skills/architecture.md §4 and §6.
+ * See docs/technical/architecture/skills/sandbox-runtime.md.
  */
 import { type AuthModule } from './auth';
 import { type ConfigModule } from './config';
 import { type SkillContext } from './context';
-import { type EventsModule } from './events';
+import { type EventHandler } from './event-handler';
 import { type IngressModule } from './ingress';
 import { type LogModule } from './logging';
 import { type ToolsModule } from './tool-registry';
@@ -43,6 +44,31 @@ export type MissionSDKOptions = {
      */
     port?: number;
 };
+/**
+ * A message from a skill to the agent.
+ *
+ * Skills process their domain-specific inbound data and produce
+ * human-readable messages that agents can reason about.
+ */
+export type AgentMessage = {
+    /**
+     * Human-readable message describing what happened.
+     * This is what the agent sees and reasons about.
+     */
+    message: string;
+    /**
+     * Structured context data the agent can reference.
+     * Include IDs, metadata, and any data that helps the agent
+     * take follow-up actions using the skill's tools.
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Optional deduplication key to prevent duplicate processing.
+     * If the platform has already processed a message with this key,
+     * it will be silently dropped.
+     */
+    deduplicationKey?: string;
+};
 export type MissionSDK = {
     /** The resolved skill context. */
     context: SkillContext;
@@ -50,14 +76,41 @@ export type MissionSDK = {
     auth: AuthModule;
     /** Fetch per-installation configuration. */
     config: ConfigModule;
-    /** Send messages to the agent about external events. */
-    events: EventsModule;
     /** Register ingress handlers and discover public URLs. */
     ingress: IngressModule;
     /** Structured logger — logs are batched and shipped to the Mission platform. */
     log: LogModule;
     /** Register tool handlers that the platform can invoke. */
     tools: ToolsModule;
+    /**
+     * Subscribe to typed events delivered by the platform.
+     * Use '*' to subscribe to all event types.
+     *
+     * @example
+     * ```ts
+     * mission.on('mailbox_activity', async (event) => {
+     *   await mission.emit({ message: '...', context: event.payload })
+     * })
+     * ```
+     */
+    on: (eventName: string, handler: EventHandler) => void;
+    /**
+     * Send a message to the agent about an external event.
+     * The platform routes it to the appropriate agent(s) based on
+     * the workspace's routing configuration.
+     *
+     * Sends an agent message to the platform for processing.
+     *
+     * @example
+     * ```ts
+     * await mission.emit({
+     *   message: 'New email from john@example.com',
+     *   context: { emailAddress: 'john@example.com' },
+     *   deduplicationKey: 'gmail-push-12345'
+     * })
+     * ```
+     */
+    emit: (message: AgentMessage) => Promise<void>;
     /**
      * Connect to the Mission platform.
      *
@@ -65,14 +118,14 @@ export type MissionSDK = {
      * ingress traffic), installs the console override for structured
      * logging, and begins the keep-alive heartbeat loop.
      *
-     * After this call, `auth`, `config`, `events`, and `ingress.getPublicUrl`
+     * After this call, `auth`, `config`, `emit`, and `ingress.getPublicUrl`
      * are usable.
      */
     connect: () => Promise<void>;
     /**
      * Signal readiness and start accepting tool calls and ingress traffic.
      *
-     * Call this AFTER registering all tools and ingress handlers.
+     * Call this AFTER registering all tools, ingress handlers, and event handlers.
      * The returned promise resolves when the process receives a shutdown
      * signal (SIGTERM/SIGINT) and graceful shutdown completes.
      */
@@ -94,6 +147,28 @@ export type MissionSDK = {
      * ```
      */
     onShutdown: (handler: () => Promise<void> | void) => void;
+    /**
+     * Register a health check handler for install-time smoke testing.
+     *
+     * The handler is called by the platform after the skill process starts
+     * during installation. It should verify that the skill can reach its
+     * external dependencies (e.g., API keys work, OAuth tokens are valid).
+     *
+     * This is NOT a tool — it is never exposed to the LLM or listed in
+     * reported tools. It is served on an internal HTTP endpoint
+     * (`POST /_mission/health-check`) that only the platform calls.
+     *
+     * If no handler is registered, the health check is skipped (not failed).
+     *
+     * @example
+     * ```ts
+     * mission.onHealthCheck(async () => {
+     *   await gmail.listLabels()
+     *   return { ok: true }
+     * })
+     * ```
+     */
+    onHealthCheck: (handler: () => Promise<unknown> | unknown) => void;
 };
 /**
  * Create a Mission SDK instance.
@@ -110,6 +185,9 @@ export type MissionSDK = {
  *
  * mission.tools.registerAll(handlers)
  * mission.ingress.on('webhook', handler)
+ * mission.on('mailbox_activity', async (event) => {
+ *   await mission.emit({ message: '...', context: event.payload })
+ * })
  * mission.onShutdown(() => cleanup())
  *
  * await mission.ready()

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,QAAQ,CAAA;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,UAAU,CAAA;AAChE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACjE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAEhE,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAA;AAClB,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,WAAW,CAAA;AAClB,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAA;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAA;IACrB,kFAAkF;IAClF,IAAI,EAAE,UAAU,CAAA;IAChB,4CAA4C;IAC5C,MAAM,EAAE,YAAY,CAAA;IACpB,wDAAwD;IACxD,MAAM,EAAE,YAAY,CAAA;IACpB,0DAA0D;IAC1D,OAAO,EAAE,aAAa,CAAA;IACtB,gFAAgF;IAChF,GAAG,EAAE,SAAS,CAAA;IACd,2DAA2D;IAC3D,KAAK,EAAE,WAAW,CAAA;IAElB;;;;;;;;;OASG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;CAC1D,CAAA;AAaD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CA6TxE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,QAAQ,CAAA;AAE1D,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,UAAU,CAAA;AAChE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACjE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE/E,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAA;AAClB,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,WAAW,CAAA;AAClB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAA;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAA;IACrB,kFAAkF;IAClF,IAAI,EAAE,UAAU,CAAA;IAChB,4CAA4C;IAC5C,MAAM,EAAE,YAAY,CAAA;IACpB,0DAA0D;IAC1D,OAAO,EAAE,aAAa,CAAA;IACtB,gFAAgF;IAChF,GAAG,EAAE,SAAS,CAAA;IACd,2DAA2D;IAC3D,KAAK,EAAE,WAAW,CAAA;IAElB;;;;;;;;;;OAUG;IACH,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;;;;;;OASG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IAEzD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KAAK,IAAI,CAAA;CACnE,CAAA;AAaD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAkbxE"}