@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.2

package/transcripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts.js","sourceRoot":"","sources":["../src/transcripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6EH,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CACpC,QAA0C;IAE1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,CAAC,CAAC,YAAY;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAClC,QAA0C;IAE1C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,CAAC,CAAC,KAAK,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA0C;IAE1C,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAC/B,QAA0C,EAC1C,GAAG,GAAG,wBAAwB;IAE9B,MAAM,IAAI,GAAG,QAAQ;SAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACzB,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,UAAsB;IACxD,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC/C,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;KACvC,CAAC;AACJ,CAAC;AAQD,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CACpC,QAA0C;IAE1C,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE;QACzC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;YACxC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwC,EACxC,EAAU;IAEV,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC7B,KAAK,GAAG,GAAG,CAAC;YACZ,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAeD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAoC,EACpC,eAAe,GAAG,CAAC,EACnB,WAAW,GAAG,CAAC;IAEf,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;YAC7B,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,GAAG,WAAW,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC,OAAO,EAAE;aACzD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;YACxC,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK;gBACL,IAAI;gBACJ,MAAM,EAAE,WAAW,CAAC,CAAC,OAAO,0BAA0B,SAAS,EAAE;aAClE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,eAAe,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,eAAe,GAAG,WAAW,EAAE,CAAC;YACnE,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS,CAAC,CAAC,KAAK,2BAA2B,eAAe,EAAE;aACrE,CAAC,CAAC;QACL,CAAC;QACD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/type-guards.d.ts

@@ -0,0 +1,7 @@
+export type UnknownRecord = Record<string, unknown>;
+export declare function isPlainObject(value: unknown): value is UnknownRecord;
+export declare function asRecord(value: unknown): UnknownRecord | null;
+export declare function asRecordOrUndefined(value: unknown): UnknownRecord | undefined;
+export declare function asObjectArray(value: unknown): UnknownRecord[];
+export declare function asNonEmptyString(value: unknown): string | undefined;
+//# sourceMappingURL=type-guards.d.ts.map

package/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOpE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAK7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAE7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAM7D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAInE"}

package/type-guards.js

@@ -0,0 +1,27 @@
+export function isPlainObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.prototype.toString.call(value) === "[object Object]");
+}
+export function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+export function asRecordOrUndefined(value) {
+    return asRecord(value) ?? undefined;
+}
+export function asObjectArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item));
+}
+export function asNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=type-guards.js.map

package/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAyB,EAAE,CAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/types/index.d.ts

@@ -0,0 +1,654 @@
+export type ExistingElizaInstallSource = "config-path-env" | "state-dir-env" | "default-state-dir";
+export interface ExistingElizaInstallInfo {
+    detected: boolean;
+    stateDir: string;
+    configPath: string;
+    configExists: boolean;
+    stateDirExists: boolean;
+    hasStateEntries: boolean;
+    source: ExistingElizaInstallSource;
+}
+/**
+ * A translation function accepted by UI components.
+ *
+ * The second parameter is intentionally `Record<string, unknown>` so that
+ * callers passing narrower variable maps (e.g. `Record<string, string>`) or
+ * no second argument at all remain compatible.
+ */
+export type TranslateFn = (key: string, options?: Record<string, unknown>) => string;
+export type ChannelsStatusSnapshot = {
+    ts: number;
+    channelOrder: string[];
+    channelLabels: Record<string, string>;
+    channelDetailLabels?: Record<string, string>;
+    channelSystemImages?: Record<string, string>;
+    channelMeta?: ChannelUiMetaEntry[];
+    channels: Record<string, unknown>;
+    channelAccounts: Record<string, ChannelAccountSnapshot[]>;
+    channelDefaultAccountId: Record<string, string>;
+};
+export type ChannelUiMetaEntry = {
+    id: string;
+    label: string;
+    detailLabel: string;
+    systemImage?: string;
+};
+export type ChannelAccountSnapshot = {
+    accountId: string;
+    name?: string | null;
+    enabled?: boolean | null;
+    configured?: boolean | null;
+    linked?: boolean | null;
+    running?: boolean | null;
+    connected?: boolean | null;
+    reconnectAttempts?: number | null;
+    lastConnectedAt?: number | null;
+    lastError?: string | null;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastInboundAt?: number | null;
+    lastOutboundAt?: number | null;
+    lastProbeAt?: number | null;
+    mode?: string | null;
+    dmPolicy?: string | null;
+    allowFrom?: string[] | null;
+    tokenSource?: string | null;
+    botTokenSource?: string | null;
+    appTokenSource?: string | null;
+    credentialSource?: string | null;
+    audienceType?: string | null;
+    audience?: string | null;
+    webhookPath?: string | null;
+    webhookUrl?: string | null;
+    baseUrl?: string | null;
+    allowUnmentionedGroups?: boolean | null;
+    cliPath?: string | null;
+    dbPath?: string | null;
+    port?: number | null;
+    probe?: unknown;
+    audit?: unknown;
+    application?: unknown;
+};
+export type WhatsAppSelf = {
+    e164?: string | null;
+    jid?: string | null;
+};
+export type WhatsAppDisconnect = {
+    at: number;
+    status?: number | null;
+    error?: string | null;
+    loggedOut?: boolean | null;
+};
+export type WhatsAppStatus = {
+    configured: boolean;
+    linked: boolean;
+    authAgeMs?: number | null;
+    self?: WhatsAppSelf | null;
+    running: boolean;
+    connected: boolean;
+    lastConnectedAt?: number | null;
+    lastDisconnect?: WhatsAppDisconnect | null;
+    reconnectAttempts: number;
+    lastMessageAt?: number | null;
+    lastEventAt?: number | null;
+    lastError?: string | null;
+};
+export type TelegramBot = {
+    id?: number | null;
+    username?: string | null;
+};
+export type TelegramWebhook = {
+    url?: string | null;
+    hasCustomCert?: boolean | null;
+};
+export type TelegramProbe = {
+    ok: boolean;
+    status?: number | null;
+    error?: string | null;
+    elapsedMs?: number | null;
+    bot?: TelegramBot | null;
+    webhook?: TelegramWebhook | null;
+};
+export type TelegramStatus = {
+    configured: boolean;
+    tokenSource?: string | null;
+    running: boolean;
+    mode?: string | null;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    probe?: TelegramProbe | null;
+    lastProbeAt?: number | null;
+};
+export type DiscordBot = {
+    id?: string | null;
+    username?: string | null;
+};
+export type DiscordProbe = {
+    ok: boolean;
+    status?: number | null;
+    error?: string | null;
+    elapsedMs?: number | null;
+    bot?: DiscordBot | null;
+};
+export type DiscordStatus = {
+    configured: boolean;
+    tokenSource?: string | null;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    probe?: DiscordProbe | null;
+    lastProbeAt?: number | null;
+};
+export type GoogleChatProbe = {
+    ok: boolean;
+    status?: number | null;
+    error?: string | null;
+    elapsedMs?: number | null;
+};
+export type GoogleChatStatus = {
+    configured: boolean;
+    credentialSource?: string | null;
+    audienceType?: string | null;
+    audience?: string | null;
+    webhookPath?: string | null;
+    webhookUrl?: string | null;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    probe?: GoogleChatProbe | null;
+    lastProbeAt?: number | null;
+};
+export type SlackBot = {
+    id?: string | null;
+    name?: string | null;
+};
+export type SlackTeam = {
+    id?: string | null;
+    name?: string | null;
+};
+export type SlackProbe = {
+    ok: boolean;
+    status?: number | null;
+    error?: string | null;
+    elapsedMs?: number | null;
+    bot?: SlackBot | null;
+    team?: SlackTeam | null;
+};
+export type SlackStatus = {
+    configured: boolean;
+    botTokenSource?: string | null;
+    appTokenSource?: string | null;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    probe?: SlackProbe | null;
+    lastProbeAt?: number | null;
+};
+export type SignalProbe = {
+    ok: boolean;
+    status?: number | null;
+    error?: string | null;
+    elapsedMs?: number | null;
+    version?: string | null;
+};
+export type SignalStatus = {
+    configured: boolean;
+    baseUrl: string;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    probe?: SignalProbe | null;
+    lastProbeAt?: number | null;
+};
+export type IMessageProbe = {
+    ok: boolean;
+    error?: string | null;
+};
+export type IMessageStatus = {
+    configured: boolean;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    cliPath?: string | null;
+    dbPath?: string | null;
+    probe?: IMessageProbe | null;
+    lastProbeAt?: number | null;
+};
+export type NostrProfile = {
+    name?: string | null;
+    displayName?: string | null;
+    about?: string | null;
+    picture?: string | null;
+    banner?: string | null;
+    website?: string | null;
+    nip05?: string | null;
+    lud16?: string | null;
+};
+export type NostrStatus = {
+    configured: boolean;
+    publicKey?: string | null;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    profile?: NostrProfile | null;
+};
+export type MSTeamsProbe = {
+    ok: boolean;
+    error?: string | null;
+    appId?: string | null;
+};
+export type MSTeamsStatus = {
+    configured: boolean;
+    running: boolean;
+    lastStartAt?: number | null;
+    lastStopAt?: number | null;
+    lastError?: string | null;
+    port?: number | null;
+    probe?: MSTeamsProbe | null;
+    lastProbeAt?: number | null;
+};
+export type ConfigSnapshotIssue = {
+    path: string;
+    message: string;
+};
+export type ConfigSnapshot = {
+    path?: string | null;
+    exists?: boolean | null;
+    raw?: string | null;
+    hash?: string | null;
+    parsed?: unknown;
+    valid?: boolean | null;
+    config?: Record<string, unknown> | null;
+    issues?: ConfigSnapshotIssue[] | null;
+};
+/** A value that's either a literal or a path reference into the state model. */
+export type DynamicValue<T = unknown> = T | {
+    path: string;
+};
+/** Logic expression for complex visibility conditions. */
+export type LogicExpression = {
+    and: LogicExpression[];
+} | {
+    or: LogicExpression[];
+} | {
+    not: LogicExpression;
+} | {
+    path: string;
+} | {
+    eq: [DynamicValue, DynamicValue];
+} | {
+    neq: [DynamicValue, DynamicValue];
+} | {
+    gt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    gte: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lte: [DynamicValue<number>, DynamicValue<number>];
+};
+/**
+ * Full visibility condition — supports boolean, path, or logic expression.
+ * Used for rich conditional rendering.
+ */
+export type VisibilityCondition = boolean | {
+    path: string;
+} | LogicExpression;
+/** A single validation check: function name + args + error message. */
+export type ValidationCheck = {
+    /** Built-in or custom function name (required, email, minLength, etc.) */
+    fn: string;
+    /** Arguments for the validation function. */
+    args?: Record<string, DynamicValue>;
+    /** Error message shown when check fails. */
+    message: string;
+};
+/** Validation config for a field. */
+export type ValidationConfig = {
+    /** Array of checks to run. */
+    checks?: ValidationCheck[];
+    /** When to run validation: change | blur | submit. */
+    validateOn?: "change" | "blur" | "submit";
+    /** Condition: only validate when this is true. */
+    enabled?: LogicExpression;
+};
+/** Action binding — maps an event to an action invocation. */
+export type ActionBinding = {
+    /** Action name (must be in catalog). */
+    action: string;
+    /** Parameters to pass to the action handler. */
+    params?: Record<string, DynamicValue>;
+};
+export type ConfigUiHint = {
+    label?: string;
+    help?: string;
+    group?: string;
+    order?: number;
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+    /** Default value template for new array items (e.g. `""`, `0`, `{ key: "", value: "" }`). */
+    itemTemplate?: string | number | boolean | Record<string, string | number | boolean>;
+    /** Explicit field type override (must match a catalog field name). */
+    type?: string;
+    /** Hide this field from the UI entirely. */
+    hidden?: boolean;
+    /** Layout width hint. */
+    width?: "full" | "half" | "third";
+    /** Whether the field is read-only. */
+    readonly?: boolean;
+    /** Regex pattern for string validation. */
+    pattern?: string;
+    /** Error message when pattern doesn't match. */
+    patternError?: string;
+    /** Rich visibility condition. */
+    visible?: VisibilityCondition;
+    /** Declarative validation checks. */
+    validation?: ValidationConfig;
+    /** Event bindings — maps event names to action bindings. */
+    on?: Record<string, ActionBinding>;
+    /** Icon name for the field label. */
+    icon?: string;
+    /** Enhanced options for select/radio/multiselect fields. */
+    options?: Array<{
+        value: string;
+        label: string;
+        description?: string;
+        icon?: string;
+        disabled?: boolean;
+    }>;
+    /** Minimum value (for number fields). */
+    min?: number;
+    /** Maximum value (for number fields). */
+    max?: number;
+    /** Step increment (for number fields). */
+    step?: number;
+    /** Display unit label (e.g., "ms", "tokens", "%"). */
+    unit?: string;
+    /** Schema for array item fields. */
+    itemSchema?: ConfigUiHint;
+    /** Minimum items (for array fields). */
+    minItems?: number;
+    /** Maximum items (for array fields). */
+    maxItems?: number;
+    /** Plugin-provided custom React component name. */
+    component?: string;
+};
+/**
+ * Design tokens for consistent plugin UI rendering across environments.
+ *
+ * Consumers can override any token via CSS custom properties on a parent element,
+ * or pass a partial theme object to ConfigRenderer's `theme` prop.
+ *
+ * @example
+ * ```tsx
+ * const darkTheme: Partial<PluginUiTheme> = {
+ *   labelColor: "var(--muted)",
+ *   errorColor: "var(--destructive)",
+ *   focusRing: "var(--accent)",
+ * };
+ * ```
+ */
+export interface PluginUiTheme {
+    /** Gap between individual fields (default: "1rem") */
+    fieldGap: string;
+    /** Gap between field groups (default: "1.5rem") */
+    groupGap: string;
+    /** Padding inside group sections (default: "1.5rem") */
+    sectionPadding: string;
+    /** Font size for field labels (default: "0.8125rem" / 13px) */
+    labelSize: string;
+    /** Font size for help text below fields (default: "0.6875rem" / 11px) */
+    helpSize: string;
+    /** Font size for validation error messages (default: "0.6875rem" / 11px) */
+    errorSize: string;
+    /** Color for field labels — maps to --plugin-label or --txt */
+    labelColor: string;
+    /** Color for help text — maps to --plugin-help or --muted */
+    helpColor: string;
+    /** Color for error messages — maps to --plugin-error or --destructive */
+    errorColor: string;
+    /** Color for input borders — maps to --plugin-border or --border */
+    borderColor: string;
+    /** Color for focus ring on inputs — maps to --plugin-focus-ring or --accent */
+    focusRing: string;
+    /** Default input height (default: "2.25rem" / 36px) */
+    inputHeight: string;
+    /** Max width for text inputs (default: "32rem") */
+    maxFieldWidth: string;
+}
+export type ConfigUiHints = Record<string, ConfigUiHint>;
+export type PresenceEntry = {
+    deviceFamily?: string | null;
+    host?: string | null;
+    instanceId?: string | null;
+    ip?: string | null;
+    lastInputSeconds?: number | null;
+    mode?: string | null;
+    modelIdentifier?: string | null;
+    platform?: string | null;
+    reason?: string | null;
+    roles?: Array<string | null> | null;
+    scopes?: Array<string | null> | null;
+    text?: string | null;
+    ts?: number | null;
+    version?: string | null;
+};
+export type GatewaySessionsDefaults = {
+    model: string | null;
+    contextTokens: number | null;
+};
+export type GatewayAgentRow = {
+    id: string;
+    name?: string;
+    identity?: {
+        name?: string;
+        theme?: string;
+        emoji?: string;
+        avatar?: string;
+        avatarUrl?: string;
+    };
+};
+export type AgentsListResult = {
+    defaultId: string;
+    mainKey: string;
+    scope: string;
+    agents: GatewayAgentRow[];
+};
+export type AgentIdentityResult = {
+    agentId: string;
+    name: string;
+    avatar: string;
+    emoji?: string;
+};
+export type AgentFileEntry = {
+    name: string;
+    path: string;
+    missing: boolean;
+    size?: number;
+    updatedAtMs?: number;
+    content?: string;
+};
+export type AgentsFilesListResult = {
+    agentId: string;
+    workspace: string;
+    files: AgentFileEntry[];
+};
+export type AgentsFilesGetResult = {
+    agentId: string;
+    workspace: string;
+    file: AgentFileEntry;
+};
+export type AgentsFilesSetResult = {
+    ok: true;
+    agentId: string;
+    workspace: string;
+    file: AgentFileEntry;
+};
+export type GatewaySessionRow = {
+    key: string;
+    kind: "direct" | "group" | "global" | "unknown";
+    label?: string;
+    displayName?: string;
+    surface?: string;
+    subject?: string;
+    room?: string;
+    space?: string;
+    updatedAt: number | null;
+    sessionId?: string;
+    systemSent?: boolean;
+    abortedLastRun?: boolean;
+    thinkingLevel?: string;
+    verboseLevel?: string;
+    reasoningLevel?: string;
+    elevatedLevel?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    model?: string;
+    modelProvider?: string;
+    contextTokens?: number;
+};
+export type SessionsListResult = {
+    ts: number;
+    path: string;
+    count: number;
+    defaults: GatewaySessionsDefaults;
+    sessions: GatewaySessionRow[];
+};
+export type SessionsPatchResult = {
+    ok: true;
+    path: string;
+    key: string;
+    entry: {
+        sessionId: string;
+        updatedAt?: number;
+        thinkingLevel?: string;
+        verboseLevel?: string;
+        reasoningLevel?: string;
+        elevatedLevel?: string;
+    };
+};
+export type CronSchedule = {
+    kind: "at";
+    at: string;
+} | {
+    kind: "every";
+    everyMs: number;
+    anchorMs?: number;
+} | {
+    kind: "cron";
+    expr: string;
+    tz?: string;
+};
+export type CronSessionTarget = "main" | "isolated";
+export type CronWakeMode = "next-heartbeat" | "now";
+export type CronPayload = {
+    kind: "systemEvent";
+    text: string;
+} | {
+    kind: "agentTurn";
+    message: string;
+    thinking?: string;
+    timeoutSeconds?: number;
+};
+export type CronDelivery = {
+    mode: "none" | "announce";
+    channel?: string;
+    to?: string;
+    bestEffort?: boolean;
+};
+export type CronJobState = {
+    nextRunAtMs?: number;
+    runningAtMs?: number;
+    lastRunAtMs?: number;
+    lastStatus?: "ok" | "error" | "skipped";
+    lastError?: string;
+    lastDurationMs?: number;
+};
+export type CronJob = {
+    id: string;
+    agentId?: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    deleteAfterRun?: boolean;
+    createdAtMs: number;
+    updatedAtMs: number;
+    schedule: CronSchedule;
+    sessionTarget: CronSessionTarget;
+    wakeMode: CronWakeMode;
+    payload: CronPayload;
+    delivery?: CronDelivery;
+    state?: CronJobState;
+};
+export type CronStatus = {
+    enabled: boolean;
+    jobs: number;
+    nextWakeAtMs?: number | null;
+};
+export type CronRunLogEntry = {
+    ts: number;
+    jobId: string;
+    status: "ok" | "error" | "skipped";
+    durationMs?: number;
+    error?: string;
+    summary?: string;
+};
+export type SkillsStatusConfigCheck = {
+    path: string;
+    value: unknown;
+    satisfied: boolean;
+};
+export type SkillInstallOption = {
+    id: string;
+    kind: "brew" | "node" | "go" | "uv";
+    label: string;
+    bins: string[];
+};
+export type SkillStatusEntry = {
+    name: string;
+    description: string;
+    source: string;
+    bundled?: boolean;
+    filePath: string;
+    baseDir: string;
+    skillKey: string;
+    primaryEnv?: string;
+    emoji?: string;
+    homepage?: string;
+    always: boolean;
+    disabled: boolean;
+    blockedByAllowlist: boolean;
+    eligible: boolean;
+    requirements: {
+        bins: string[];
+        env: string[];
+        config: string[];
+        os: string[];
+    };
+    missing: {
+        bins: string[];
+        env: string[];
+        config: string[];
+        os: string[];
+    };
+    configChecks: SkillsStatusConfigCheck[];
+    install: SkillInstallOption[];
+};
+export type SkillStatusReport = {
+    workspaceDir: string;
+    managedSkillsDir: string;
+    skills: SkillStatusEntry[];
+};
+export type StatusSummary = Record<string, unknown>;
+export type HealthSnapshot = Record<string, unknown>;
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+//# sourceMappingURL=index.d.ts.map