fuli-context 0.7.9 → 0.7.10-beta.7

package/graph-provider/fuli_graph/store_knowledge.py

@@ -32,7 +32,7 @@ class StoreKnowledge:
                 self, actor, space, request.personal_project_id
             )
         if request.project_agent_id:
-            await authorize_project_agent(
+            agent = await authorize_project_agent(
                 self,
                 actor,
                 space,
@@ -41,6 +41,7 @@ class StoreKnowledge:
                 require_active=True,
                 require_memory=True,
             )
+            request = request.model_copy(update={'project_agent_id': agent['agent_id']})
         return await self._commit_episode(
             space,
             request.episode,
@@ -65,7 +66,7 @@ class StoreKnowledge:
                 self, actor, space, request.personal_project_id
             )
         if request.project_agent_id:
-            await authorize_project_agent(
+            agent = await authorize_project_agent(
                 self,
                 actor,
                 space,
@@ -74,6 +75,7 @@ class StoreKnowledge:
                 require_active=True,
                 require_memory=True,
             )
+            request = request.model_copy(update={'project_agent_id': agent['agent_id']})
         return await self._commit_episode(
             space,
             request.episode,

package/graph-provider/fuli_graph/store_project_agent_attention.py

@@ -0,0 +1,138 @@
+import hashlib
+import json
+
+from fastapi import HTTPException
+
+from .personal_project_access import authorize_personal_project
+from .project_agent_access import authorize_project_agent
+from .project_agent_attention_models import (
+    AgentAttentionCreate, AgentAttentionDecision, AgentAttentionList,
+    AgentAttentionRecord,
+)
+from .provider_values import native_datetime, now_utc, stable_uuid
+from .system_hr_identity import resolve_hr_alias
+
+
+class StoreProjectAgentAttention:
+    """Explicit human requests; never infer attention from worker/task status."""
+
+    async def create_agent_attention(self, actor, request: AgentAttentionCreate):
+        self._require_personal()
+        space = await self.authorize(actor, request.personal_space_id, 'maintainer')
+        agent_id = await resolve_hr_alias(self, request.personal_space_id, request.agent_id)
+        await authorize_project_agent(
+            self, actor, space, request.personal_project_id, agent_id,
+            require_active=True,
+            allow_unassigned=agent_id in {
+                'employee.bole', 'employee.jefa', 'fuli-project-coordinator',
+            },
+        )
+        if request.task_id:
+            task = await self._find_task_row(
+                request.personal_space_id, request.task_id,
+                request.personal_project_id,
+            )
+            if not task:
+                raise HTTPException(status_code=404, detail='project Agent task not found')
+        payload = request.model_dump(exclude={'idempotency_key'})
+        fingerprint = hashlib.sha256(json.dumps(payload, sort_keys=True).encode()).hexdigest()
+        payload['agent_id'] = agent_id
+        request_id = stable_uuid(
+            self.settings.provider_id, request.personal_space_id,
+            request.personal_project_id, 'agent-attention', request.idempotency_key,
+        )
+        timestamp = now_utc()
+        rows, _, _ = await self.runtime.driver.execute_query(
+            '''
+            MATCH (space:FuliSpace {id: $personal_space_id, kind: 'personal'})
+            MERGE (request:FuliAgentAttention {id: $request_id})
+            ON CREATE SET request += $payload,
+                          request.request_id = $request_id,
+                          request.fingerprint = $fingerprint,
+                          request.status = 'open', request.revision = 0,
+                          request.created_at = $timestamp,
+                          request.updated_at = $timestamp
+            MERGE (space)-[:HAS_AGENT_ATTENTION]->(request)
+            RETURN request
+            ''',
+            personal_space_id=request.personal_space_id, request_id=request_id,
+            payload=payload, fingerprint=fingerprint, timestamp=timestamp,
+        )
+        raw = dict(rows[0]['request'])
+        if raw['fingerprint'] != fingerprint:
+            raise HTTPException(status_code=409, detail='attention idempotency key conflict')
+        return attention_record(raw)
+
+    async def list_agent_attention(
+        self, actor, personal_space_id, personal_project_id=None,
+        agent_id=None, status='open', limit=100, offset=0,
+    ):
+        self._require_personal()
+        space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
+        if personal_project_id:
+            await authorize_personal_project(self, actor, space, personal_project_id)
+        rows, _, _ = await self.runtime.driver.execute_query(
+            '''
+            MATCH (:FuliSpace {id: $space_id, kind: 'personal'})-
+                  [:HAS_AGENT_ATTENTION]->(request:FuliAgentAttention)
+            WHERE ($project_id IS NULL OR request.personal_project_id = $project_id)
+              AND ($agent_id IS NULL OR request.agent_id = $agent_id)
+              AND ($status IS NULL OR request.status = $status)
+            WITH request ORDER BY request.created_at DESC, request.request_id
+            WITH collect(request) AS requests
+            RETURN requests[$offset..($offset + $limit)] AS items,
+                   size(requests) AS total,
+                   [r IN requests WHERE r.status = 'open' | r.agent_id] AS open_agents
+            ''', space_id=personal_space_id, project_id=personal_project_id,
+            agent_id=agent_id, status=status, limit=limit, offset=offset, routing_='r',
+        )
+        row = rows[0] if rows else {'items': [], 'total': 0, 'open_agents': []}
+        counts = {}
+        for agent in row['open_agents']:
+            counts[agent] = counts.get(agent, 0) + 1
+        return AgentAttentionList(
+            items=[attention_record(dict(item)) for item in row['items']],
+            total=row['total'], counts=counts,
+        )
+
+    async def decide_agent_attention(
+        self, actor, request: AgentAttentionDecision, *, human: bool,
+    ):
+        self._require_personal()
+        space = await self.authorize(actor, request.personal_space_id, 'maintainer')
+        await authorize_personal_project(self, actor, space, request.personal_project_id)
+        timestamp = now_utc()
+        # Increment obtains a write lock before the revision predicate is checked.
+        # A stale caller cannot overwrite the response recorded by another client.
+        rows, _, _ = await self.runtime.driver.execute_query(
+            '''
+            MATCH (:FuliSpace {id: $space_id, kind: 'personal'})-
+                  [:HAS_AGENT_ATTENTION]->(request:FuliAgentAttention {
+                    request_id: $request_id, personal_project_id: $project_id
+                  })
+            SET request.lock_version = coalesce(request.lock_version, 0) + 1
+            WITH request
+            WHERE request.revision = $revision AND request.status = 'open'
+            SET request.status = $status, request.response = $response,
+                request.responded_by = $responded_by,
+                request.revision = request.revision + 1,
+                request.updated_at = $timestamp
+            RETURN request
+            ''', space_id=request.personal_space_id,
+            project_id=request.personal_project_id, request_id=request.request_id,
+            revision=request.expected_revision, response=request.response,
+            status='resolved' if human else 'cancelled',
+            responded_by='human' if human else 'agent', timestamp=timestamp,
+        )
+        if not rows:
+            raise HTTPException(status_code=409, detail='attention changed or is no longer open; reload it')
+        return attention_record(dict(rows[0]['request']))
+
+
+def attention_record(raw):
+    return AgentAttentionRecord(**{
+        key: native_datetime(raw.get(key)) if key in {'created_at', 'updated_at'} else raw.get(key)
+        for key in AgentAttentionRecord.model_fields
+        if key in raw
+    })

package/graph-provider/fuli_graph/store_project_agent_executor_learning.py

@@ -22,6 +22,7 @@ from .project_agent_executor_models import (
 from .project_agent_models import ProjectAgentModelStrategy
 from .provider_values import native_datetime, now_utc, stable_uuid
 from .store_transactions import query_store_transaction
+from .system_hr_identity import resolve_hr_alias
 
 
 _TERMINAL_NEUTRAL = {'cancelled'}
@@ -276,6 +277,7 @@ class StoreProjectAgentExecutorLearning:
     ) -> list[ProjectAgentExecutorOutcomeEvidenceRecord]:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         await authorize_personal_project(
             self,
             actor,
@@ -334,6 +336,7 @@ class StoreProjectAgentExecutorLearning:
 
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         if personal_project_id is not None:
             await authorize_personal_project(
                 self,
@@ -367,12 +370,17 @@ class StoreProjectAgentExecutorLearning:
         aggregates: list[ProjectAgentExecutorOutcomeAggregate] = []
         for row in records:
             raw = dict(row.get('aggregate') or {})
+            identity = raw.get('agent_id')
             aggregate_json = raw.get('aggregate_json')
             if aggregate_json:
                 try:
                     raw.update(json.loads(aggregate_json))
                 except (TypeError, ValueError):
                     pass
+            if raw.get('hr_identity_original_refs_json'):
+                raw['agent_id'] = identity
+            raw.pop('hr_identity_original_refs_json', None)
+            raw.pop('hr_identity_original_id', None)
             # Storage identities are intentionally internal: the public model
             # remains the provider-neutral bucket contract.
             raw.pop('id', None)

package/graph-provider/fuli_graph/store_project_agent_memory.py

@@ -16,6 +16,7 @@ from .project_agent_memory_models import (
     ProjectAgentMemoryWrite,
 )
 from .provider_values import now_utc, stable_uuid
+from .system_hr_identity import LEGACY_HR_AGENT_ID, SYSTEM_HR_AGENT_ID, resolve_hr_alias
 
 
 class StoreProjectAgentMemory:
@@ -24,7 +25,7 @@ class StoreProjectAgentMemory:
     ) -> ProjectAgentMemoryView:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
-        await authorize_project_agent(
+        agent = await authorize_project_agent(
             self, actor, space, personal_project_id, agent_id, require_memory=True,
         )
         records, _, _ = await self.runtime.driver.execute_query(
@@ -34,21 +35,21 @@ class StoreProjectAgentMemory:
             RETURN checkpoint.record_json AS record_json
             ORDER BY checkpoint.revision DESC LIMIT $limit
             ''',
-            memory_id=self._agent_memory_id(
-                personal_space_id, personal_project_id, agent_id,
-            ),
+            memory_id=await self._resolved_agent_memory_id(
+                personal_space_id, personal_project_id, agent['agent_id']),
             limit=max(1, min(limit, 10)),
             routing_='r',
         )
         history = [
-            ProjectAgentMemoryRecord.model_validate_json(row['record_json'])
+            ProjectAgentMemoryRecord.model_validate_json(row['record_json']).model_copy(
+                update={'agent_id': agent['agent_id']})
             for row in records
         ]
         current = history[0] if history else None
         return ProjectAgentMemoryView(
             personal_space_id=personal_space_id,
             personal_project_id=personal_project_id,
-            agent_id=agent_id,
+            agent_id=agent['agent_id'],
             revision=current.revision if current else 0,
             current=current,
             history=history,
@@ -78,14 +79,14 @@ class StoreProjectAgentMemory:
                 ''',
                 space_id=request.personal_space_id,
                 project_id=request.personal_project_id,
-                agent_id=request.agent_id,
+                agent_id=agent['agent_id'],
                 task_id=request.task_id,
                 routing_='r',
             )
             if not task_rows:
                 raise HTTPException(status_code=404, detail='Agent memory task not found')
-        memory_id = self._agent_memory_id(
-            request.personal_space_id, request.personal_project_id, request.agent_id,
+        memory_id = await self._resolved_agent_memory_id(
+            request.personal_space_id, request.personal_project_id, agent['agent_id'],
         )
         checkpoint_id = stable_uuid(memory_id, request.idempotency_key)
         payload = request.model_dump(mode='json', exclude={
@@ -98,7 +99,7 @@ class StoreProjectAgentMemory:
             checkpoint_id=checkpoint_id,
             personal_space_id=request.personal_space_id,
             personal_project_id=request.personal_project_id,
-            agent_id=request.agent_id,
+            agent_id=agent['agent_id'],
             revision=request.expected_revision + 1,
             memory=request.memory,
             source_application=request.source_application,
@@ -147,7 +148,7 @@ class StoreProjectAgentMemory:
             ''',
             space_id=request.personal_space_id,
             project_id=request.personal_project_id,
-            agent_id=request.agent_id,
+            agent_id=agent['agent_id'],
             memory_id=memory_id,
             checkpoint_id=checkpoint_id,
             expected_revision=request.expected_revision,
@@ -164,9 +165,35 @@ class StoreProjectAgentMemory:
                 status_code=409,
                 detail='Agent memory changed; reload its latest revision before merging notes',
             )
-        if row['payload_hash'] != payload_hash:
+        compatible_hashes = {payload_hash}
+        if LEGACY_HR_AGENT_ID in agent.get('legacy_agent_ids', []):
+            # Old checkpoints keep their exact IDs/JSON/hashes. A canonical
+            # retry of the same input may differ only in the identity spelling.
+            for identity in (LEGACY_HR_AGENT_ID, SYSTEM_HR_AGENT_ID):
+                compatible_hashes.add(hashlib.sha256(json.dumps(
+                    {**payload, 'agent_id': identity}, sort_keys=True,
+                    ensure_ascii=False, separators=(',', ':'),
+                ).encode()).hexdigest())
+        if row['payload_hash'] not in compatible_hashes:
             raise HTTPException(status_code=409, detail='memory idempotency key has different input')
-        return ProjectAgentMemoryRecord.model_validate_json(row['record_json'])
+        return ProjectAgentMemoryRecord.model_validate_json(row['record_json']).model_copy(
+            update={'agent_id': agent['agent_id']})
+
+    async def _resolved_agent_memory_id(self, space_id, project_id, agent_id):
+        agent_id = await resolve_hr_alias(self, space_id, agent_id)
+        if agent_id == SYSTEM_HR_AGENT_ID:
+            rows, _, _ = await self.runtime.driver.execute_query(
+                '''MATCH (:FuliSpace {id: $space_id})-[:HAS_PROJECT_AGENT_IDENTITY]->
+                         (:FuliProjectAgent {agent_id: $agent_id})-[:HAS_WORKING_MEMORY]->
+                         (head:FuliProjectAgentMemory {personal_space_id: $space_id,
+                           personal_project_id: $project_id})
+                   RETURN DISTINCT head.id AS id''',
+                space_id=space_id, project_id=project_id, agent_id=agent_id, routing_='r')
+            if len(rows) > 1:
+                raise HTTPException(409, 'Agent has conflicting memory heads')
+            if rows:
+                return rows[0]['id']
+        return self._agent_memory_id(space_id, project_id, agent_id)
 
     def _agent_memory_id(self, space_id, project_id, agent_id):
         return stable_uuid(

package/graph-provider/fuli_graph/store_project_agent_task_recruitment.py

@@ -24,6 +24,7 @@ from .project_agent_task_models import (
     ProjectAgentRoutingDecisionRecord,
 )
 from .provider_values import native_datetime, now_utc, stable_uuid
+from .store_project_agents import SYSTEM_HR_AGENT_ID
 from .store_transactions import query_store_transaction
 
 
@@ -744,9 +745,11 @@ class StoreProjectAgentTaskRecruitment:
             MATCH (:FuliSpace {id: $personal_space_id, kind: 'personal'})-
                   [:HAS_PROJECT_AGENT_IDENTITY]->
                   (hr:FuliProjectAgent {agent_type: 'hr', status: 'active'})
-            RETURN hr ORDER BY hr.created_at, hr.agent_id LIMIT 1
+            RETURN hr ORDER BY CASE WHEN hr.agent_id = $system_hr_agent_id
+              THEN 0 ELSE 1 END, hr.created_at, hr.agent_id LIMIT 1
             ''',
             personal_space_id=request.personal_space_id,
+            system_hr_agent_id=SYSTEM_HR_AGENT_ID,
             routing_='r',
         )
         hr_agent_id = (

package/graph-provider/fuli_graph/store_project_agent_task_staffing.py

@@ -7,6 +7,7 @@ from fastapi import HTTPException
 from .project_agent_access import authorize_project_agent
 from .project_agent_models import ProjectAgentProfile
 from .project_agent_task_models import ProjectAgentParallelPlan
+from .store_project_agents import SYSTEM_HR_AGENT_ID
 
 
 class StoreProjectAgentTaskStaffing:
@@ -634,9 +635,11 @@ class StoreProjectAgentTaskStaffing:
             MATCH (space:FuliSpace {id: $personal_space_id, kind: 'personal'})-
                   [:HAS_PROJECT_AGENT_IDENTITY]->
                   (hr:FuliProjectAgent {agent_type: 'hr', status: 'active'})
-            RETURN hr LIMIT 1
+            RETURN hr ORDER BY CASE WHEN hr.agent_id = $system_hr_agent_id
+              THEN 0 ELSE 1 END, hr.created_at, hr.agent_id LIMIT 1
             ''',
             personal_space_id=request.personal_space_id,
+            system_hr_agent_id=SYSTEM_HR_AGENT_ID,
             routing_='r',
         )
         if not hr_records:

package/graph-provider/fuli_graph/store_project_agent_tasks.py

@@ -2,6 +2,7 @@ import json
 from collections import defaultdict
 from datetime import date
 from fastapi import HTTPException
+from .system_hr_identity import resolve_hr_alias
 from .personal_project_access import authorize_personal_project
 from .project_agent_access import authorize_project_agent
 from .project_agent_models import ProjectAgentModelStrategy, ProjectAgentProfile
@@ -470,6 +471,7 @@ class StoreProjectAgentTasks(
     ) -> list[ProjectAgentTaskRecord]:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         if personal_project_id:
             await authorize_personal_project(
                 self,
@@ -510,6 +512,7 @@ class StoreProjectAgentTasks(
     ) -> ProjectAgentActivityResult:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         if personal_project_id:
             await authorize_personal_project(
                 self,

package/graph-provider/fuli_graph/store_project_agents.py

@@ -18,12 +18,87 @@ from .project_agent_models import (
     ProjectAgentUpsert,
 )
 from .provider_values import native_datetime, now_utc, stable_uuid
+from .project_agent_names import agent_display_name
+from .store_transactions import query_store_transaction
+from .system_hr_identity import LEGACY_HR_AGENT_ID, merge_legacy_hr, resolve_hr_alias
 
 
 SYSTEM_COORDINATOR_AGENT_ID = 'fuli-project-coordinator'
+SYSTEM_HR_AGENT_ID = 'employee.bole'
 
 
 class StoreProjectAgents:
+    async def ensure_system_project_hr(
+        self,
+        actor: dict,
+        personal_space_id: str,
+    ) -> ProjectAgentRecord:
+        self._require_personal()
+        await self.authorize(actor, personal_space_id, 'maintainer')
+        async with query_store_transaction(self) as scoped:
+            await scoped._ensure_system_project_hr_identity(personal_space_id)
+            await merge_legacy_hr(scoped, personal_space_id)
+        return await self.get_project_agent(actor, personal_space_id, None, SYSTEM_HR_AGENT_ID)
+
+    async def _ensure_system_project_hr_identity(self, personal_space_id):
+        profile = ProjectAgentProfile(
+            name='Bole',
+            occupation_emoji='🔎',
+            responsibility=(
+                '维护 Agent 人员分布、当前工作与可审计招募记录，'
+                '并在需要新角色时执行受策略约束的招募。'
+            ),
+            agent_type='hr',
+            work_kinds=['agent-recruitment', 'staffing-review'],
+            capabilities=[
+                'Agent 招募', '人员分布', '工作状态', '招募审计',
+                'fuli.employee:bole',
+            ],
+            initial_preferences=[
+                '每次招募保留任务、原因、触发来源与时间线。',
+                '只展示 Provider 已记录的人员状态，不推测未上报的工作。',
+            ],
+            status='active',
+        )
+        updated_at = now_utc()
+        node_id = stable_uuid(
+            self.settings.provider_id,
+            personal_space_id,
+            'project-agent',
+            SYSTEM_HR_AGENT_ID,
+        )
+        await self.runtime.driver.execute_query(
+            '''
+            MATCH (space:FuliSpace {id: $personal_space_id, kind: 'personal'})
+            MERGE (agent:FuliProjectAgent {id: $id})
+            ON CREATE SET agent.agent_id = $agent_id,
+                          agent.created_at = $updated_at,
+                          agent.system_managed = true
+            ON CREATE SET agent.profile_json = $profile_json,
+                          agent.name = $name,
+                          agent.occupation_emoji = $occupation_emoji,
+                          agent.responsibility = $responsibility,
+                          agent.capabilities = $capabilities,
+                          agent.work_kinds = $work_kinds,
+                          agent.agent_type = 'hr',
+                          agent.memory_scope = 'reviewed_agent',
+                          agent.status = 'active',
+                          agent.updated_at = $updated_at
+            MERGE (space)-[:HAS_PROJECT_AGENT_IDENTITY]->(agent)
+            RETURN agent
+            ''',
+            personal_space_id=personal_space_id,
+            id=node_id,
+            agent_id=SYSTEM_HR_AGENT_ID,
+            profile_json=profile.model_dump_json(),
+            name=profile.name,
+            occupation_emoji=profile.occupation_emoji,
+            responsibility=profile.responsibility,
+            capabilities=profile.capabilities,
+            work_kinds=profile.work_kinds,
+            updated_at=updated_at,
+        )
+
     async def ensure_system_project_coordinator(
         self,
         actor: dict,
@@ -93,6 +168,8 @@ class StoreProjectAgents:
         recruitment_id: str | None = None,
     ) -> ProjectAgentRecord:
         self._require_personal()
+        if request.agent_id == LEGACY_HR_AGENT_ID:
+            raise HTTPException(409, 'This HR identity has moved to employee.bole')
         if request.profile.agent_type == 'temporary' and not recruitment_id:
             raise HTTPException(
                 status_code=422,
@@ -106,6 +183,14 @@ class StoreProjectAgents:
                 status_code=422,
                 detail='only the system-managed identity may use coordinator type',
             )
+        if (
+            request.profile.agent_type == 'hr'
+            and request.agent_id != SYSTEM_HR_AGENT_ID
+        ):
+            raise HTTPException(
+                status_code=422,
+                detail='only the system-managed Bole identity may use HR type',
+            )
         if (
             request.agent_id == SYSTEM_COORDINATOR_AGENT_ID
             and request.profile.agent_type != 'coordinator'
@@ -114,6 +199,19 @@ class StoreProjectAgents:
                 status_code=422,
                 detail='the system coordinator identity cannot change Agent type',
             )
+        if (
+            request.agent_id == SYSTEM_HR_AGENT_ID
+            and request.profile.agent_type != 'hr'
+        ):
+            raise HTTPException(
+                status_code=422,
+                detail='the system HR identity cannot change Agent type',
+            )
+        if request.agent_id == SYSTEM_HR_AGENT_ID and request.profile.status != 'active':
+            raise HTTPException(
+                status_code=422,
+                detail='the system HR must remain active',
+            )
         space = await self.authorize(actor, request.personal_space_id, 'maintainer')
         if request.personal_project_id:
             await authorize_personal_project(
@@ -344,6 +442,7 @@ class StoreProjectAgents:
     ) -> ProjectAgentRecord:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         if personal_project_id:
             await authorize_personal_project(
                 self,
@@ -391,6 +490,11 @@ class StoreProjectAgents:
                 status_code=422,
                 detail='the system coordinator cannot be archived',
             )
+        if agent_id == SYSTEM_HR_AGENT_ID:
+            raise HTTPException(
+                status_code=422,
+                detail='the system HR cannot be archived',
+            )
         await self.authorize(actor, personal_space_id, 'maintainer')
         if not reason.strip():
             raise HTTPException(status_code=422, detail='archive reason is required')
@@ -696,6 +800,7 @@ class StoreProjectAgents:
     ) -> list[ProjectAgentAssignmentRecord]:
         self._require_personal()
         space = await self.authorize(actor, personal_space_id, 'reader')
+        agent_id = await resolve_hr_alias(self, personal_space_id, agent_id)
         if personal_project_id:
             await authorize_personal_project(
                 self,
@@ -974,6 +1079,9 @@ class StoreProjectAgents:
     ) -> ProjectAgentRecord:
         raw = dict(row['agent'])
         profile = ProjectAgentProfile.model_validate_json(raw['profile_json'])
+        profile = profile.model_copy(update={
+            'display_name': agent_display_name(raw['agent_id'], profile.name, profile.display_name),
+        })
         # ``occupation_emoji`` was introduced after the original profile JSON
         # contract.  Prefer the durable profile value, but tolerate an older
         # JSON payload while the explicit node property is being backfilled.
@@ -1066,6 +1174,7 @@ class StoreProjectAgents:
         })
         return ProjectAgentRecord(
             agent_id=raw['agent_id'],
+            legacy_agent_ids=list(raw.get('legacy_agent_ids') or []),
             personal_space_id=personal_space_id,
             personal_project_id=projection_project_id,
             profile=profile,

package/graph-provider/fuli_graph/store_task_contexts.py

@@ -143,7 +143,7 @@ class StoreTaskContexts:
         # The existing checkpoint lets pre-upgrade claims retry without new writes.
         memory_checkpoint_id = None
         if record['project_agent_id'] and record['personal_project_id']:
-            memory_checkpoint_id = stable_uuid(self._agent_memory_id(
+            memory_checkpoint_id = stable_uuid(await self._resolved_agent_memory_id(
                 request.personal_space_id, record['personal_project_id'],
                 record['project_agent_id'],
             ), f'{token}:memory')