@axiom-lattice/core 4.2.3 → 4.2.4

package/dist/index.d.mts

@@ -1825,6 +1825,22 @@ declare class AgentLatticeManager extends BaseLatticeManager<AgentLattice> {
      * 获取Lattice类型前缀
      */
     protected getLatticeType(): string;
+    /**
+     * Suffix that identifies ephemeral general-purpose subagent assistants.
+     *
+     * The subagents middleware (deep_agent_new) registers a runtime agent
+     * `{assistant_id}-general-purpose` in the process that executes the task.
+     * Other processes (e.g. the Gateway serving thread state/messages) never see
+     * that in-memory registration, so lattice lookups for the suffixed key fall
+     * back to the parent assistant's lattice.
+     */
+    private static readonly GENERAL_PURPOSE_SUFFIX;
+    /**
+     * Returns the parent assistant key for a `{parent}-general-purpose` key, or
+     * `null` when the key is not a suffixed GP key (including the bare
+     * `general-purpose` key itself).
+     */
+    private generalPurposeParentKey;
     /**
      * 带租户注册Agent Lattice
      * @param tenantId 租户ID
@@ -1833,16 +1849,44 @@ declare class AgentLatticeManager extends BaseLatticeManager<AgentLattice> {
     registerLatticeWithTenant(tenantId: string, config: AgentConfig): void;
     /**
      * 带租户获取AgentLattice
+     *
+     * @remarks
+     * For unregistered `{parent}-general-purpose` keys (ephemeral subagent
+     * assistants created by the subagents middleware), this falls back to the
+     * parent assistant's lattice so that read paths (thread state/messages)
+     * resolve in processes where the runtime GP registration is absent.
+     * {@link hasAgentLatticeWithTenant} stays strict.
+     *
      * @param tenantId 租户ID
      * @param key Lattice键名
      */
     getAgentLatticeWithTenant(tenantId: string, key: string): AgentLattice | undefined;
     /**
      * 带租户检查Lattice是否存在
+     *
+     * @remarks
+     * Deliberately strict: `{parent}-general-purpose` keys are NOT covered by
+     * the read fallback. The subagents middleware relies on this check to decide
+     * whether to register the real GP runtime agent; a permissive check would
+     * skip that registration and silently run the parent graph for GP tasks.
+     *
      * @param tenantId 租户ID
      * @param key Lattice键名
      */
     hasAgentLatticeWithTenant(tenantId: string, key: string): boolean;
+    /**
+     * 异步获取AgentLattice（内存未命中时尝试从store加载）
+     *
+     * @remarks
+     * Mirrors {@link getAgentLatticeWithTenant}'s general-purpose fallback: an
+     * unregistered `{parent}-general-purpose` key resolves to the parent
+     * assistant's lattice. This is the lookup used by `getAgentClientAsync`,
+     * which backs Gateway thread state/message reads for GP subagent threads.
+     *
+     * @param tenantId 租户ID
+     * @param key Lattice键名
+     */
+    getOrLoadWithTenant(tenantId: string, key: string): Promise<AgentLattice | undefined>;
     /**
      * 带租户移除Lattice
      * @param tenantId 租户ID

package/dist/index.d.ts

@@ -1825,6 +1825,22 @@ declare class AgentLatticeManager extends BaseLatticeManager<AgentLattice> {
      * 获取Lattice类型前缀
      */
     protected getLatticeType(): string;
+    /**
+     * Suffix that identifies ephemeral general-purpose subagent assistants.
+     *
+     * The subagents middleware (deep_agent_new) registers a runtime agent
+     * `{assistant_id}-general-purpose` in the process that executes the task.
+     * Other processes (e.g. the Gateway serving thread state/messages) never see
+     * that in-memory registration, so lattice lookups for the suffixed key fall
+     * back to the parent assistant's lattice.
+     */
+    private static readonly GENERAL_PURPOSE_SUFFIX;
+    /**
+     * Returns the parent assistant key for a `{parent}-general-purpose` key, or
+     * `null` when the key is not a suffixed GP key (including the bare
+     * `general-purpose` key itself).
+     */
+    private generalPurposeParentKey;
     /**
      * 带租户注册Agent Lattice
      * @param tenantId 租户ID
@@ -1833,16 +1849,44 @@ declare class AgentLatticeManager extends BaseLatticeManager<AgentLattice> {
     registerLatticeWithTenant(tenantId: string, config: AgentConfig): void;
     /**
      * 带租户获取AgentLattice
+     *
+     * @remarks
+     * For unregistered `{parent}-general-purpose` keys (ephemeral subagent
+     * assistants created by the subagents middleware), this falls back to the
+     * parent assistant's lattice so that read paths (thread state/messages)
+     * resolve in processes where the runtime GP registration is absent.
+     * {@link hasAgentLatticeWithTenant} stays strict.
+     *
      * @param tenantId 租户ID
      * @param key Lattice键名
      */
     getAgentLatticeWithTenant(tenantId: string, key: string): AgentLattice | undefined;
     /**
      * 带租户检查Lattice是否存在
+     *
+     * @remarks
+     * Deliberately strict: `{parent}-general-purpose` keys are NOT covered by
+     * the read fallback. The subagents middleware relies on this check to decide
+     * whether to register the real GP runtime agent; a permissive check would
+     * skip that registration and silently run the parent graph for GP tasks.
+     *
      * @param tenantId 租户ID
      * @param key Lattice键名
      */
     hasAgentLatticeWithTenant(tenantId: string, key: string): boolean;
+    /**
+     * 异步获取AgentLattice（内存未命中时尝试从store加载）
+     *
+     * @remarks
+     * Mirrors {@link getAgentLatticeWithTenant}'s general-purpose fallback: an
+     * unregistered `{parent}-general-purpose` key resolves to the parent
+     * assistant's lattice. This is the lookup used by `getAgentClientAsync`,
+     * which backs Gateway thread state/message reads for GP subagent threads.
+     *
+     * @param tenantId 租户ID
+     * @param key Lattice键名
+     */
+    getOrLoadWithTenant(tenantId: string, key: string): Promise<AgentLattice | undefined>;
     /**
      * 带租户移除Lattice
      * @param tenantId 租户ID