lua-cli 3.23.2 → 3.25.0

package/dist/api-exports.d.ts

@@ -1046,6 +1046,22 @@ export declare interface ChatHistoryMessage {
  */
 export declare type ChatMessage = TextMessage | ImageMessage | FileMessage;
 
+/**
+ * Options for creating a custom data entry.
+ */
+declare interface CreateCustomDataOptions {
+    /** Text used for semantic (vector) search indexing of this entry. */
+    searchText?: string;
+    /**
+     * Declare `data` fields this agent queries with filters, so the platform
+     * maintains agent-scoped database indexes for them. Entries are a single
+     * field path (`'business_id'`) or a compound of up to 2 paths
+     * (`['country', 'business_id']`). Idempotent — declare on every write; an
+     * index whose declaration stops arriving is removed after ~14 days.
+     */
+    index?: Array<string | string[]>;
+}
+
 /**
  * Response from creating custom data entry.
  * Includes optional similarity score for search results.
@@ -1096,7 +1112,8 @@ declare interface CustomDataAPI {
      * @param searchText - Optional text for vector search indexing
      * @returns Promise resolving to created entry (DataEntryInstance)
      */
-    create(collectionName: string, data: Record<string, any>, searchText?: string): Promise<DataEntryInstance>;
+    collections(): Promise<CustomDataCollectionsResponse>;
+    create(collectionName: string, data: Record<string, any>, optionsOrSearchText?: string | CreateCustomDataOptions): Promise<DataEntryInstance>;
     /**
      * Gets entries from a collection with filtering and pagination.
      * @param collectionName - Collection name
@@ -1121,7 +1138,7 @@ declare interface CustomDataAPI {
      * @param searchText - Optional text for vector search indexing
      * @returns Promise resolving to update response
      */
-    update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
+    update(collectionName: string, entryId: string, data: Record<string, any>, optionsOrSearchText?: string | CreateCustomDataOptions): Promise<UpdateCustomDataResponse>;
     /** Atomically sets and removes top-level entry fields and optionally changes search text. */
     patch(collectionName: string, entryId: string, mutation: {
         set?: Record<string, any>;
@@ -1146,6 +1163,29 @@ declare interface CustomDataAPI {
     delete(collectionName: string, entryId: string): Promise<DeleteCustomDataResponse>;
 }
 
+/** One collection in the agent's Data namespace, from Data.collections(). */
+declare interface CustomDataCollectionInfo {
+    name: string;
+    entryCount: number;
+    lastUpdatedAt: number;
+    firstCreatedAt: number;
+    /** Managed index declarations for this collection — present only when declared. */
+    indexes?: CustomDataIndexStatus[];
+}
+
+declare interface CustomDataCollectionsResponse {
+    data: CustomDataCollectionInfo[];
+    count: number;
+}
+
+declare interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
+    id: string;
+    data: Record<string, any>;
+    createdAt: number;
+    updatedAt: number;
+    searchText?: string;
+}
+
 /**
  * Custom data entry.
  * Represents a single entry in a custom data collection.
@@ -1155,12 +1195,15 @@ declare interface CustomDataAPI {
  * - Vector search via searchText
  * - Automatic timestamps
  */
-declare interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
-    id: string;
-    data: Record<string, any>;
-    createdAt: number;
-    updatedAt: number;
-    searchText?: string;
+/** Status of one managed index declaration, from the collections listing. */
+declare interface CustomDataIndexStatus {
+    fields: string[];
+    /** pending | building | ready | failed | rejected */
+    status: string;
+    /** Populated when status is failed/rejected — the reason, verbatim. */
+    error?: string;
+    lastDeclaredAt: number;
+    lastUsedAt?: number;
 }
 
 /**
@@ -1168,18 +1211,59 @@ declare interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
  * Store and retrieve custom data with vector search capabilities
  */
 export declare const Data: {
+    /**
+     * Lists this agent's data collections, including managed index status
+     * (fields, pending/building/ready/failed/rejected, error reasons) for any
+     * declared indexes — the fastest way to diagnose a declaration.
+     *
+     * @returns Promise resolving to `{ data: CustomDataCollectionInfo[], count }`
+     */
+    collections(): Promise<CustomDataCollectionsResponse>;
     /**
      * Creates a new entry in a custom data collection.
      *
+     * Declaring indexes: if your agent FILTERS this collection (e.g.
+     * `Data.get(c, { business_id: 123 })`), declare the filtered fields here so
+     * the platform maintains an index for them:
+     *
+     * ```typescript
+     * await Data.create('inference_cache', doc, { index: ['business_id'] });
+     * // Compound index (fields queried together) — note the NESTED array:
+     * await Data.create('inference_cache', doc, { index: [['country', 'business_id']] });
+     * // ['country', 'business_id'] WITHOUT nesting = two separate single-field
+     * // indexes, which will NOT serve a combined filter efficiently.
+     * ```
+     *
+     * Index semantics — read before relying on them:
+     * - Builds are ASYNCHRONOUS: allow minutes after first declaration before
+     *   expecting fast queries. Check status via `Data.collections()`.
+     * - A compound index serves filters on its leftmost field(s) only:
+     *   `[['country','business_id']]` serves `{country}` and
+     *   `{country, business_id}`, but NOT `{business_id}` alone.
+     * - Limits: 2 fields per index, 3 declarations per call, 5 indexes per
+     *   agent. Over-limit or invalid declarations are REJECTED (visible in
+     *   index status), never silently trimmed.
+     * - Lifecycle: an index stays while your agent uses it (declaring writes OR
+     *   matching filtered reads keep it alive) and is removed ~14 days after
+     *   all usage stops. No cleanup code needed.
+     *
      * @param collectionName - Name of the collection
      * @param data - Data to store
-     * @param searchText - Optional text for vector search indexing
+     * @param optionsOrSearchText - Options object `{ searchText?, index? }`.
+     *   Passing a bare string (legacy) sets `searchText` only — easy to confuse
+     *   with an index declaration, so prefer the object form.
      * @returns Promise resolving to created entry
      */
-    create(collectionName: string, data: Record<string, any>, searchText?: string): Promise<DataEntryInstance>;
+    create(collectionName: string, data: Record<string, any>, optionsOrSearchText?: string | CreateCustomDataOptions): Promise<DataEntryInstance>;
     /**
      * Retrieves entries from a collection with optional filtering and pagination.
      *
+     * Filtering a LARGE collection? Declare the filtered fields where you store
+     * data — `Data.create(c, doc, { index: ['your_field'] })` — or queries will
+     * slow down as the collection grows and eventually fail with an error
+     * message naming the unindexed field and the declaration to add. Filtered reads on a declared field keep its index
+     * alive automatically.
+     *
      * @param collectionName - Name of the collection
      * @param filter - Optional filter criteria
      * @param page - Page number (default: 1)
@@ -1204,7 +1288,7 @@ export declare const Data: {
      * @param searchText - Optional new search text for vector search indexing
      * @returns Promise resolving to update response
      */
-    update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
+    update(collectionName: string, entryId: string, data: Record<string, any>, optionsOrSearchText?: string | CreateCustomDataOptions): Promise<UpdateCustomDataResponse>;
     /**
      * Performs vector search on a collection.
      *
@@ -1747,6 +1831,60 @@ declare interface ImmutableUserProfile {
     emailAddresses: string[];
 }
 
+/**
+ * PRO-1208 (B7) — `User.Inbox.push()`: the governed SDK door into a user's
+ * inbox. Shared between the sandbox runtime (the SDK surface), lua-core (the
+ * seam's `runInboxPush`) and lua-api (the lua-cli dev route) so all three
+ * speak one wire contract.
+ */
+/** What the card offers. `approve` requires `options` (routed through the
+ *  agent-question path so answers are one click); `fix` requires
+ *  `connection`; plain notices need neither. */
+declare type InboxPushAction = 'approve' | 'redirect' | 'fix';
+
+declare interface InboxPushInput {
+    /** Card title — the row's first line. 1..140 chars after trim. */
+    title: string;
+    /** The human body — the row's context line and the detail pane's prose. */
+    body: string;
+    /** Optional longer detail shown only in the drill-in pane. */
+    detail?: string;
+    /** Primary link out (issue URL, doc permalink) — rendered as the card's
+     *  source link, never auto-opened. */
+    deeplink?: string;
+    /** Server-clamped: urgent is limited per day and demoted when over budget. */
+    priority?: 'urgent' | 'high' | 'normal' | 'low';
+    actions?: InboxPushAction[];
+    /** One-click answers (2..4). Presence routes the push through the
+     *  agent-question path — the user's pick resolves the card. */
+    options?: {
+        label: string;
+        description?: string;
+    }[];
+    /** For `fix`: the integration the agent needs — catalog slug + display name. */
+    connection?: {
+        type: string;
+        name: string;
+    };
+    /** Idempotency/revision key: same key = revise the existing card in place,
+     *  never a second knock. Omit for one-shot notices. */
+    key?: string;
+    /** Conversation the card should hand off into when the user acts. */
+    threadId?: string;
+}
+
+declare type InboxPushOutcome = 'deposited' | 'updated' | 'exists' | 'capped';
+
+declare interface InboxPushReceipt {
+    outcome: InboxPushOutcome;
+    /** The inbox kind the push routed to. */
+    kind: 'input_request' | 'connection_fix' | 'agent_notice';
+    /** Echo of the dedup key (or the generated one) — reuse it to revise. */
+    key: string;
+    /** Present on `capped`: what to tell the agent author. */
+    reason?: string;
+}
+
 /**
  * Job with versions array
  * Matches JobDto and job.schema.ts
@@ -2284,6 +2422,7 @@ export declare const Lua: LuaRuntime;
  */
 export declare class LuaAgent {
     private readonly name;
+    private readonly description?;
     private readonly persona;
     private readonly model?;
     private readonly modelSettings?;
@@ -2318,6 +2457,8 @@ export declare class LuaAgent {
      */
     constructor(config: LuaAgentConfig);
     getName(): string;
+    /** Capability summary consumed by Space routing. */
+    getDescription(): string | undefined;
     /** Browser switch (LuaBrowser) — `true`/config when the agent can browse. */
     getBrowser(): LuaAgentConfig['browser'];
     getPersona(): PersonaText;
@@ -2338,6 +2479,12 @@ export declare class LuaAgent {
 export declare interface LuaAgentConfig {
     /** Agent name (used for identification) */
     name: string;
+    /**
+     * Short capability summary used by Spaces to decide when to delegate to
+     * this agent. Keep this focused on what the agent can do; the persona owns
+     * behavior, voice, and detailed instructions.
+     */
+    description?: string;
     /** Agent persona - defines the agent's behavior and personality */
     persona: PersonaText;
     /** LLM model to use — 'provider/model' string or resolver function */
@@ -5461,6 +5608,21 @@ export declare const User: {
      * ```
      */
     getChatHistory(): Promise<ChatHistoryMessage[]>;
+    /**
+     * PRO-1208 (B7) — push an approve/redirect/fix card to YOUR OWN inbox.
+     * Capped (5/day per agent), urgent-clamped, same-`key` deduped (revise in
+     * place). Cap-hit resolves to `{outcome: 'capped'}` — never throws.
+     *
+     * @example
+     * const receipt = await User.Inbox.push({
+     *   title: 'Nightly digest ready',
+     *   body: 'Built and filed to the Library.',
+     *   key: 'nightly-digest',
+     * });
+     */
+    Inbox: {
+        push(input: InboxPushInput): Promise<InboxPushReceipt>;
+    };
 };
 
 /**

package/dist/api-exports.js

@@ -351,6 +351,9 @@ function isDesktopFileCommandName(value) {
 function isDesktopFileSessionId(value) {
   return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
 }
+function isImplicitModelSelectionSource(source) {
+  return source !== void 0 && IMPLICIT_MODEL_SELECTION_SOURCES.includes(source);
+}
 function resolveRequireToolApproval(rules) {
   const raw = rules?.requireToolApproval ?? rules?.requireApproval;
   if (raw === void 0 || raw === null) return void 0;
@@ -378,7 +381,7 @@ function normalizeLuaJobExecutionTimeoutSeconds(timeout) {
   }
   return Math.min(Math.max(timeout, LUA_JOB_MIN_TIMEOUT_SECONDS), LUA_JOB_MAX_TIMEOUT_SECONDS);
 }
-var __defProp2, __name2, CHANNEL_SEND_CHANNELS, REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST, REVIEWABLE_MCP_SEND_TOOL_SUFFIX, MCP_TOOL_READ_VERB_RE, MCP_DRAFT_CREATE_VERBS, NON_INTERACTIVE_CHANNELS, RICH_PARTS_MESSAGE_ID_PREFIX, SCREENSHOT_MESSAGE_ID_PREFIX, BROWSER_COMMANDS, BROWSER_COMMAND_NAMES, DESKTOP_FILE_COMMANDS, DESKTOP_FILE_COMMAND_SET, REASONING_EFFORT_VALUES, AGENT_NAME_TOKEN, DEFAULT_PERSONA_GUIDE, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema, LUA_JOB_DEFAULT_TIMEOUT_SECONDS, LUA_JOB_MIN_TIMEOUT_SECONDS, LUA_JOB_MAX_TIMEOUT_SECONDS;
+var __defProp2, __name2, CHANNEL_SEND_CHANNELS, REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST, REVIEWABLE_MCP_SEND_TOOL_SUFFIX, MCP_TOOL_READ_VERB_RE, MCP_DRAFT_CREATE_VERBS, NON_INTERACTIVE_CHANNELS, RICH_PARTS_MESSAGE_ID_PREFIX, SCREENSHOT_MESSAGE_ID_PREFIX, BROWSER_COMMANDS, BROWSER_COMMAND_NAMES, DESKTOP_FILE_COMMANDS, DESKTOP_FILE_COMMAND_SET, REASONING_EFFORT_VALUES, IMPLICIT_MODEL_SELECTION_SOURCES, AGENT_NAME_TOKEN, DEFAULT_PERSONA_GUIDE, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema, LUA_JOB_DEFAULT_TIMEOUT_SECONDS, LUA_JOB_MIN_TIMEOUT_SECONDS, LUA_JOB_MAX_TIMEOUT_SECONDS;
 var init_dist = __esm({
   "../shared-types/dist/index.mjs"() {
     "use strict";
@@ -701,6 +704,12 @@ var init_dist = __esm({
       "high",
       "max"
     ];
+    IMPLICIT_MODEL_SELECTION_SOURCES = [
+      "workspace-default",
+      "platform-default"
+    ];
+    __name(isImplicitModelSelectionSource, "isImplicitModelSelectionSource");
+    __name2(isImplicitModelSelectionSource, "isImplicitModelSelectionSource");
     __name(resolveRequireToolApproval, "resolveRequireToolApproval");
     __name2(resolveRequireToolApproval, "resolveRequireToolApproval");
     AGENT_NAME_TOKEN = "[Your Agent Name]";
@@ -4476,17 +4485,42 @@ var init_custom_data_api_service = __esm({
         this.agentId = agentId;
       }
       /**
+      * Lists the agent's data collections with entry counts, timestamps, and —
+      * when declared — managed index status (fields, pending/building/ready/
+      * failed/rejected, error reason). The place to diagnose index declarations.
+      * @returns Promise resolving to the collections listing
+      */
+      async collections() {
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/custom-data`, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+        if (response.success && response.data) {
+          return response.data;
+        }
+        throw new Error(response.error?.message || "Failed to list custom data collections");
+      }
+      /**
       * Creates a new custom data entry in a specified collection
       * @param collectionName - The name of the collection to create the entry in
       * @param data - The data object to store in the entry
-      * @param searchText - Optional text to be used for semantic search indexing
+      * @param optionsOrSearchText - Either a searchText string (legacy form) or an
+      *   options object: `searchText` for semantic search indexing, and `index` to
+      *   declare data fields this agent filters on (e.g. `['business_id']` or
+      *   compounds like `[['country', 'business_id']]`). Declared fields get
+      *   agent-scoped database indexes maintained by the platform: created when
+      *   first declared, removed automatically ~14 days after the code stops
+      *   declaring them. Declaring on every write is the intended, idempotent use.
       * @returns Promise resolving to a DataEntryInstance representing the created entry
       * @throws Error if the entry creation fails or the API request is unsuccessful
       */
-      async create(collectionName, data, searchText) {
+      async create(collectionName, data, optionsOrSearchText) {
+        const options = typeof optionsOrSearchText === "string" ? {
+          searchText: optionsOrSearchText
+        } : optionsOrSearchText ?? {};
         const response = await this.httpPost(`/developer/agents/${this.agentId}/custom-data/${collectionName}`, {
           data,
-          searchText
+          searchText: options.searchText,
+          index: options.index
         }, {
           Authorization: `Bearer ${this.apiKey}`
         });
@@ -4539,14 +4573,19 @@ var init_custom_data_api_service = __esm({
       * @param collectionName - The name of the collection containing the entry
       * @param entryId - The unique identifier of the entry to update
       * @param data - The data object to update
-      * @param searchText - Optional text to be used for semantic search indexing
+      * @param optionsOrSearchText - searchText string (legacy) or { searchText?, index? };
+      *   `index` refreshes this agent's index declarations (same semantics as create)
       * @returns Promise resolving to an UpdateCustomDataResponse with the updated entry details
       * @throws Error if the entry is not found or the update fails
       */
-      async update(collectionName, entryId, data, searchText) {
+      async update(collectionName, entryId, data, optionsOrSearchText) {
+        const options = typeof optionsOrSearchText === "string" ? {
+          searchText: optionsOrSearchText
+        } : optionsOrSearchText ?? {};
         const response = await this.httpPut(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, {
           data,
-          searchText
+          searchText: options.searchText,
+          index: options.index
         }, {
           Authorization: `Bearer ${this.apiKey}`
         });
@@ -5792,6 +5831,31 @@ var init_channels_send_api_service = __esm({
   }
 });
 
+// src/api/inbox-push.api.service.ts
+var InboxPushApiService;
+var init_inbox_push_api_service = __esm({
+  "src/api/inbox-push.api.service.ts"() {
+    "use strict";
+    init_http_client();
+    InboxPushApiService = class extends HttpClient {
+      static {
+        __name(this, "InboxPushApiService");
+      }
+      apiKey;
+      agentId;
+      constructor(baseUrl, apiKey, agentId) {
+        super(baseUrl), this.apiKey = apiKey, this.agentId = agentId;
+      }
+      /** POST /developer/agents/:agentId/inbox/push */
+      async push(input) {
+        return this.httpPost(`/developer/agents/${this.agentId}/inbox/push`, input, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+      }
+    };
+  }
+});
+
 // src/api/directory.api.service.ts
 var DirectoryApiService;
 var init_directory_api_service = __esm({
@@ -5927,6 +5991,7 @@ __export(lazy_instances_exports, {
   getDeveloperInstance: () => getDeveloperInstance,
   getDeviceInstance: () => getDeviceInstance,
   getDirectoryInstance: () => getDirectoryInstance,
+  getInboxPushInstance: () => getInboxPushInstance,
   getJobInstance: () => getJobInstance,
   getOrderInstance: () => getOrderInstance,
   getProductsInstance: () => getProductsInstance,
@@ -6034,6 +6099,13 @@ async function getVoiceInstance() {
   }
   return _voiceInstance;
 }
+async function getInboxPushInstance() {
+  if (!_inboxPushInstance) {
+    const creds = await getCredentials();
+    _inboxPushInstance = new InboxPushApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+  }
+  return _inboxPushInstance;
+}
 async function getChannelsSendInstance() {
   if (!_channelsSendInstance) {
     const creds = await getCredentials();
@@ -6065,7 +6137,7 @@ function clearAllInstances() {
   _channelsSendInstance = null;
   _directoryInstance = null;
 }
-var _userInstance, _dataInstance, _productsInstance, _basketsInstance, _orderInstance, _webhookInstance, _jobInstance, _aiInstance, _agentsInstance, _whatsAppTemplatesInstance, _cdnInstance, _developerInstance, _voiceInstance, _channelsSendInstance, _directoryInstance, _deviceInstance;
+var _userInstance, _dataInstance, _productsInstance, _basketsInstance, _orderInstance, _webhookInstance, _jobInstance, _aiInstance, _agentsInstance, _whatsAppTemplatesInstance, _cdnInstance, _developerInstance, _voiceInstance, _channelsSendInstance, _directoryInstance, _deviceInstance, _inboxPushInstance;
 var init_lazy_instances = __esm({
   "src/api/lazy-instances.ts"() {
     "use strict";
@@ -6085,6 +6157,7 @@ var init_lazy_instances = __esm({
     init_developer_api_service();
     init_voice_api_service();
     init_channels_send_api_service();
+    init_inbox_push_api_service();
     init_directory_api_service();
     _userInstance = null;
     _dataInstance = null;
@@ -6116,6 +6189,8 @@ var init_lazy_instances = __esm({
     __name(getDeviceInstance, "getDeviceInstance");
     __name(getDeveloperInstance, "getDeveloperInstance");
     __name(getVoiceInstance, "getVoiceInstance");
+    _inboxPushInstance = null;
+    __name(getInboxPushInstance, "getInboxPushInstance");
     __name(getChannelsSendInstance, "getChannelsSendInstance");
     __name(getDirectoryInstance, "getDirectoryInstance");
     __name(clearAllInstances, "clearAllInstances");
@@ -6607,6 +6682,7 @@ var LuaAgent = class {
     __name(this, "LuaAgent");
   }
   name;
+  description;
   persona;
   model;
   modelSettings;
@@ -6641,6 +6717,7 @@ var LuaAgent = class {
   */
   constructor(config) {
     this.name = config.name;
+    this.description = config.description;
     this.persona = config.persona;
     this.model = config.model;
     if (config.modelSettings !== void 0) {
@@ -6669,6 +6746,10 @@ var LuaAgent = class {
   getName() {
     return this.name;
   }
+  /** Capability summary consumed by Space routing. */
+  getDescription() {
+    return this.description;
+  }
   /** Browser switch (LuaBrowser) — `true`/config when the agent can browse. */
   getBrowser() {
     return this.browser;
@@ -6890,24 +6971,88 @@ var User = {
   async getChatHistory() {
     const instance = await getUserInstance();
     return instance.getChatHistory();
+  },
+  /**
+  * PRO-1208 (B7) — push an approve/redirect/fix card to YOUR OWN inbox.
+  * Capped (5/day per agent), urgent-clamped, same-`key` deduped (revise in
+  * place). Cap-hit resolves to `{outcome: 'capped'}` — never throws.
+  *
+  * @example
+  * const receipt = await User.Inbox.push({
+  *   title: 'Nightly digest ready',
+  *   body: 'Built and filed to the Library.',
+  *   key: 'nightly-digest',
+  * });
+  */
+  Inbox: {
+    async push(input) {
+      const { getInboxPushInstance: getInboxPushInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+      const service = await getInboxPushInstance2();
+      const res = await service.push(input);
+      return res.data;
+    }
   }
 };
 var Data = {
+  /**
+  * Lists this agent's data collections, including managed index status
+  * (fields, pending/building/ready/failed/rejected, error reasons) for any
+  * declared indexes — the fastest way to diagnose a declaration.
+  *
+  * @returns Promise resolving to `{ data: CustomDataCollectionInfo[], count }`
+  */
+  async collections() {
+    const instance = await getDataInstance();
+    return instance.collections();
+  },
   /**
   * Creates a new entry in a custom data collection.
   *
+  * Declaring indexes: if your agent FILTERS this collection (e.g.
+  * `Data.get(c, { business_id: 123 })`), declare the filtered fields here so
+  * the platform maintains an index for them:
+  *
+  * ```typescript
+  * await Data.create('inference_cache', doc, { index: ['business_id'] });
+  * // Compound index (fields queried together) — note the NESTED array:
+  * await Data.create('inference_cache', doc, { index: [['country', 'business_id']] });
+  * // ['country', 'business_id'] WITHOUT nesting = two separate single-field
+  * // indexes, which will NOT serve a combined filter efficiently.
+  * ```
+  *
+  * Index semantics — read before relying on them:
+  * - Builds are ASYNCHRONOUS: allow minutes after first declaration before
+  *   expecting fast queries. Check status via `Data.collections()`.
+  * - A compound index serves filters on its leftmost field(s) only:
+  *   `[['country','business_id']]` serves `{country}` and
+  *   `{country, business_id}`, but NOT `{business_id}` alone.
+  * - Limits: 2 fields per index, 3 declarations per call, 5 indexes per
+  *   agent. Over-limit or invalid declarations are REJECTED (visible in
+  *   index status), never silently trimmed.
+  * - Lifecycle: an index stays while your agent uses it (declaring writes OR
+  *   matching filtered reads keep it alive) and is removed ~14 days after
+  *   all usage stops. No cleanup code needed.
+  *
   * @param collectionName - Name of the collection
   * @param data - Data to store
-  * @param searchText - Optional text for vector search indexing
+  * @param optionsOrSearchText - Options object `{ searchText?, index? }`.
+  *   Passing a bare string (legacy) sets `searchText` only — easy to confuse
+  *   with an index declaration, so prefer the object form.
   * @returns Promise resolving to created entry
   */
-  async create(collectionName, data, searchText) {
+  async create(collectionName, data, optionsOrSearchText) {
     const instance = await getDataInstance();
-    return instance.create(collectionName, data, searchText);
+    return instance.create(collectionName, data, optionsOrSearchText);
   },
   /**
   * Retrieves entries from a collection with optional filtering and pagination.
   *
+  * Filtering a LARGE collection? Declare the filtered fields where you store
+  * data — `Data.create(c, doc, { index: ['your_field'] })` — or queries will
+  * slow down as the collection grows and eventually fail with an error
+  * message naming the unindexed field and the declaration to add. Filtered reads on a declared field keep its index
+  * alive automatically.
+  *
   * @param collectionName - Name of the collection
   * @param filter - Optional filter criteria
   * @param page - Page number (default: 1)
@@ -6938,9 +7083,9 @@ var Data = {
   * @param searchText - Optional new search text for vector search indexing
   * @returns Promise resolving to update response
   */
-  async update(collectionName, entryId, data, searchText) {
+  async update(collectionName, entryId, data, optionsOrSearchText) {
     const instance = await getDataInstance();
-    return instance.update(collectionName, entryId, data, searchText);
+    return instance.update(collectionName, entryId, data, optionsOrSearchText);
   },
   /**
   * Performs vector search on a collection.