fuli-context 0.7.6 → 0.7.8

package/graph-provider/fuli_graph/knowledge_audit_models.py

@@ -0,0 +1,171 @@
+from datetime import datetime
+from typing import Any, Literal
+
+from pydantic import Field, model_validator
+
+from .model_base import StrictModel
+
+
+KnowledgeItemKind = Literal['entity', 'relationship']
+KnowledgeOperationActor = Literal['human', 'agent']
+HumanChangeStatus = Literal['none', 'unseen', 'viewed', 'reviewed']
+KnowledgeAuditAction = Literal[
+    'human_change',
+    'agent_view',
+    'agent_review',
+    'knowledge_used',
+    'knowledge_feedback',
+]
+KnowledgeUseKind = Literal['cited', 'applied']
+KnowledgeFeedbackKind = Literal[
+    'rejected',
+    'validation_failed',
+    'contradicted',
+    'outdated',
+]
+KnowledgeRevisionAction = Literal[
+    'confirm',
+    'update',
+    'invalidate',
+    'link_replacement',
+    'restore',
+    'scope_change',
+    'batch_confirm',
+    'promote_common',
+    'replace_common_duplicate',
+]
+PreferenceScope = Literal['global', 'project']
+
+
+class KnowledgeAssignmentChange(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    item_kind: KnowledgeItemKind
+    target_project_id: str = Field(min_length=1, max_length=128)
+    reason: str = Field(min_length=1, max_length=2000)
+    operation_actor: KnowledgeOperationActor = 'agent'
+
+
+class PreferenceScopeChange(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    item_kind: KnowledgeItemKind
+    scope: PreferenceScope
+    project_id: str | None = Field(default=None, min_length=1, max_length=128)
+    reason: str = Field(min_length=1, max_length=2000)
+    operation_actor: KnowledgeOperationActor = 'agent'
+
+    @model_validator(mode='after')
+    def validate_project_scope(self):
+        if self.scope == 'project' and not self.project_id:
+            raise ValueError('project_id is required for project preference scope')
+        if self.scope == 'global' and self.project_id:
+            raise ValueError('project_id is only valid for project preference scope')
+        return self
+
+
+class KnowledgeRevisionRecord(StrictModel):
+    id: str
+    item_id: str
+    item_kind: KnowledgeItemKind
+    action: KnowledgeRevisionAction
+    reason: str
+    previous: dict[str, Any] = Field(default_factory=dict)
+    current: dict[str, Any] = Field(default_factory=dict)
+    created_at: datetime
+
+
+class KnowledgeAuditRecord(StrictModel):
+    id: str
+    item_id: str
+    item_kind: KnowledgeItemKind
+    action: KnowledgeAuditAction
+    human_change_version: int = Field(default=0, ge=0)
+    reason: str
+    tool_name: str | None = None
+    task_id: str | None = None
+    session_id: str | None = None
+    use_kind: KnowledgeUseKind | None = None
+    feedback_kind: KnowledgeFeedbackKind | None = None
+    reported_by_kind: Literal[
+        'user',
+        'agent',
+        'authoritative_source',
+    ] | None = None
+    evidence_summary: str | None = None
+    source_uri: str | None = None
+    usage_generation: int | None = Field(default=None, ge=1)
+    conflict_check: Literal['no_conflict', 'conflict'] | None = None
+    classification_check: Literal['reasonable', 'needs_change'] | None = None
+    outcome: Literal[
+        'pending_review',
+        'requires_attention',
+        'reviewed',
+        'agent_confirmed',
+    ] | None = None
+    created_at: datetime
+
+
+class KnowledgeAgentViewItem(StrictModel):
+    item_id: str = Field(min_length=1, max_length=256)
+    item_kind: KnowledgeItemKind
+
+
+class KnowledgeAgentViewCreate(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    tool_name: str = Field(min_length=1, max_length=128)
+    items: list[KnowledgeAgentViewItem] = Field(max_length=200)
+
+
+class KnowledgeAgentViewResult(StrictModel):
+    recorded_count: int = Field(ge=0, le=200)
+    item_keys: list[str] = Field(max_length=200)
+
+
+class KnowledgeAgentReviewCreate(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    item_kind: KnowledgeItemKind
+    human_change_version: int = Field(ge=1)
+    conflict_check: Literal['no_conflict', 'conflict']
+    classification_check: Literal['reasonable', 'needs_change']
+    note: str = Field(min_length=1, max_length=2000)
+
+
+class KnowledgeHumanChangeSearchRequest(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    query: str = Field(default='', max_length=2048)
+    status: Literal[
+        'all',
+        'human_changed',
+        'unseen',
+        'viewed',
+        'reviewed',
+    ] = 'all'
+    limit: int = Field(default=50, ge=1, le=200)
+
+
+class KnowledgeHumanChangeItem(StrictModel):
+    item_id: str
+    item_kind: KnowledgeItemKind
+    title: str
+    body: str
+    type: str
+    human_change_status: HumanChangeStatus
+    human_change_version: int = Field(ge=1)
+    last_human_changed_at: datetime
+    last_agent_viewed_at: datetime | None = None
+    last_agent_reviewed_at: datetime | None = None
+    audit_events: list[KnowledgeAuditRecord] = Field(default_factory=list)
+
+
+class KnowledgeHumanChangeSearchResult(StrictModel):
+    items: list[KnowledgeHumanChangeItem] = Field(default_factory=list)
+
+
+class KnowledgeAssignmentRecord(StrictModel):
+    id: str
+    item_id: str
+    item_kind: KnowledgeItemKind
+    project_id: str
+    previous_project_id: str | None = None
+    reason: str
+    created_at: datetime
+    updated_at: datetime

package/graph-provider/fuli_graph/model_base.py

@@ -0,0 +1,5 @@
+from pydantic import BaseModel, ConfigDict
+
+
+class StrictModel(BaseModel):
+    model_config = ConfigDict(extra='forbid', str_strip_whitespace=True)

package/graph-provider/fuli_graph/model_validation.py

@@ -1,6 +1,7 @@
 import json
 import re
 from typing import Any
+from urllib.parse import urlsplit
 
 
 _CREDENTIAL_PATTERNS = (
@@ -162,6 +163,37 @@ def normalize_provider_url(value: str) -> str:
     return value.rstrip('/')
 
 
+def normalize_source_session_url(value: str | None) -> str | None:
+    """Allow auditable session links without accepting credential-bearing URLs."""
+
+    if value is None:
+        return None
+    normalized = value.strip()
+    parsed = urlsplit(normalized)
+    is_codex_thread = (
+        parsed.scheme == 'codex'
+        and parsed.netloc == 'threads'
+        and bool(parsed.path.strip('/'))
+    )
+    is_https = parsed.scheme == 'https' and bool(parsed.netloc)
+    is_loopback_http = (
+        parsed.scheme == 'http'
+        and parsed.hostname in {'127.0.0.1', 'localhost', '::1'}
+    )
+    if (
+        not normalized
+        or parsed.username
+        or parsed.password
+        or parsed.query
+        or parsed.fragment
+        or not (is_codex_thread or is_https or is_loopback_http)
+    ):
+        raise ValueError(
+            'source session URL must be a Codex thread, HTTPS, or loopback URL'
+        )
+    return normalized
+
+
 def complete_epistemic_state(
     *,
     origin_quadrant: str,

package/graph-provider/fuli_graph/models.py

@@ -4,13 +4,34 @@ from urllib.parse import urlsplit
 
 from pydantic import (
     AliasChoices,
-    BaseModel,
-    ConfigDict,
     Field,
     field_validator,
     model_validator,
 )
 
+from .knowledge_audit_models import (
+    HumanChangeStatus,
+    KnowledgeAgentReviewCreate,
+    KnowledgeAgentViewCreate,
+    KnowledgeAgentViewItem,
+    KnowledgeAgentViewResult,
+    KnowledgeAssignmentChange,
+    KnowledgeAssignmentRecord,
+    KnowledgeAuditAction,
+    KnowledgeAuditRecord,
+    KnowledgeFeedbackKind,
+    KnowledgeHumanChangeItem,
+    KnowledgeHumanChangeSearchRequest,
+    KnowledgeHumanChangeSearchResult,
+    KnowledgeItemKind,
+    KnowledgeOperationActor,
+    KnowledgeRevisionAction,
+    KnowledgeRevisionRecord,
+    KnowledgeUseKind,
+    PreferenceScope,
+    PreferenceScopeChange,
+)
+from .model_base import StrictModel
 from .model_validation import (
     complete_epistemic_state,
     normalize_provider_url,
@@ -52,39 +73,11 @@ ProjectRelationType = Literal[
     'RELATED_TO',
 ]
 ProjectRelationStatus = Literal['pending', 'active', 'rejected']
-KnowledgeItemKind = Literal['entity', 'relationship']
-KnowledgeOperationActor = Literal['human', 'agent']
-HumanChangeStatus = Literal['none', 'unseen', 'viewed', 'reviewed']
-KnowledgeAuditAction = Literal[
-    'human_change',
-    'agent_view',
-    'agent_review',
-    'knowledge_used',
-    'knowledge_feedback',
-]
-KnowledgeUseKind = Literal['cited', 'applied']
-KnowledgeFeedbackKind = Literal[
-    'rejected',
-    'validation_failed',
-    'contradicted',
-    'outdated',
-]
 KnowledgeInheritanceMode = Literal[
     'local_only',
     'descendants',
     'selected_projects',
 ]
-KnowledgeRevisionAction = Literal[
-    'confirm',
-    'update',
-    'invalidate',
-    'link_replacement',
-    'restore',
-    'scope_change',
-    'batch_confirm',
-    'promote_common',
-    'replace_common_duplicate',
-]
 KnowledgeContentRevisionAction = Literal[
     'confirm',
     'update',
@@ -103,7 +96,6 @@ EpistemicStatus = Literal['confirmed', 'observed', 'exploratory']
 ConfirmationStatus = Literal['confirmed', 'agent_confirmed', 'pending']
 ConfirmationActorKind = Literal['user', 'agent', 'authoritative_source', 'import']
 PersonalProfileAspect = Literal['taste', 'personality', 'judgment_preference']
-PreferenceScope = Literal['global', 'project']
 ScopedPreferenceScope = Literal['global', 'project', 'agent']
 PreferenceConflictQueueStatus = Literal['ai_pending', 'resolved']
 PreferenceConflictResolutionAction = Literal[
@@ -112,11 +104,9 @@ PreferenceConflictResolutionAction = Literal[
     'keep_right',
     'split_scope',
 ]
-SourceApplication = Literal['codex', 'claude_code', 'cursor', 'kiro', 'other']
-
-
-class StrictModel(BaseModel):
-    model_config = ConfigDict(extra='forbid', str_strip_whitespace=True)
+SourceApplication = Literal[
+    'codex', 'claude', 'claude_code', 'cursor', 'kiro', 'other'
+]
 
 
 def _validated_source_uri(value: str) -> str:
@@ -1163,137 +1153,3 @@ class KnowledgeBatchConfirmationResult(StrictModel):
     confirmed_count: int = Field(ge=0, le=200)
     confirmed_at: datetime
     item_keys: list[str] = Field(max_length=200)
-
-
-class KnowledgeAssignmentChange(StrictModel):
-    personal_space_id: str = Field(min_length=1, max_length=128)
-    item_kind: KnowledgeItemKind
-    target_project_id: str = Field(min_length=1, max_length=128)
-    reason: str = Field(min_length=1, max_length=2000)
-    operation_actor: KnowledgeOperationActor = 'agent'
-
-
-class PreferenceScopeChange(StrictModel):
-    personal_space_id: str = Field(min_length=1, max_length=128)
-    item_kind: KnowledgeItemKind
-    scope: PreferenceScope
-    project_id: str | None = Field(default=None, min_length=1, max_length=128)
-    reason: str = Field(min_length=1, max_length=2000)
-    operation_actor: KnowledgeOperationActor = 'agent'
-
-    @model_validator(mode='after')
-    def validate_project_scope(self):
-        if self.scope == 'project' and not self.project_id:
-            raise ValueError('project_id is required for project preference scope')
-        if self.scope == 'global' and self.project_id:
-            raise ValueError('project_id is only valid for project preference scope')
-        return self
-
-
-class KnowledgeRevisionRecord(StrictModel):
-    id: str
-    item_id: str
-    item_kind: KnowledgeItemKind
-    action: KnowledgeRevisionAction
-    reason: str
-    previous: dict[str, Any] = Field(default_factory=dict)
-    current: dict[str, Any] = Field(default_factory=dict)
-    created_at: datetime
-
-
-class KnowledgeAuditRecord(StrictModel):
-    id: str
-    item_id: str
-    item_kind: KnowledgeItemKind
-    action: KnowledgeAuditAction
-    human_change_version: int = Field(default=0, ge=0)
-    reason: str
-    tool_name: str | None = None
-    task_id: str | None = None
-    session_id: str | None = None
-    use_kind: KnowledgeUseKind | None = None
-    feedback_kind: KnowledgeFeedbackKind | None = None
-    reported_by_kind: Literal[
-        'user',
-        'agent',
-        'authoritative_source',
-    ] | None = None
-    evidence_summary: str | None = None
-    source_uri: str | None = None
-    usage_generation: int | None = Field(default=None, ge=1)
-    conflict_check: Literal['no_conflict', 'conflict'] | None = None
-    classification_check: Literal['reasonable', 'needs_change'] | None = None
-    outcome: Literal[
-        'pending_review',
-        'requires_attention',
-        'reviewed',
-        'agent_confirmed',
-    ] | None = None
-    created_at: datetime
-
-
-class KnowledgeAgentViewItem(StrictModel):
-    item_id: str = Field(min_length=1, max_length=256)
-    item_kind: KnowledgeItemKind
-
-
-class KnowledgeAgentViewCreate(StrictModel):
-    personal_space_id: str = Field(min_length=1, max_length=128)
-    tool_name: str = Field(min_length=1, max_length=128)
-    items: list[KnowledgeAgentViewItem] = Field(max_length=200)
-
-
-class KnowledgeAgentViewResult(StrictModel):
-    recorded_count: int = Field(ge=0, le=200)
-    item_keys: list[str] = Field(max_length=200)
-
-
-class KnowledgeAgentReviewCreate(StrictModel):
-    personal_space_id: str = Field(min_length=1, max_length=128)
-    item_kind: KnowledgeItemKind
-    human_change_version: int = Field(ge=1)
-    conflict_check: Literal['no_conflict', 'conflict']
-    classification_check: Literal['reasonable', 'needs_change']
-    note: str = Field(min_length=1, max_length=2000)
-
-
-class KnowledgeHumanChangeSearchRequest(StrictModel):
-    personal_space_id: str = Field(min_length=1, max_length=128)
-    query: str = Field(default='', max_length=2048)
-    status: Literal[
-        'all',
-        'human_changed',
-        'unseen',
-        'viewed',
-        'reviewed',
-    ] = 'all'
-    limit: int = Field(default=50, ge=1, le=200)
-
-
-class KnowledgeHumanChangeItem(StrictModel):
-    item_id: str
-    item_kind: KnowledgeItemKind
-    title: str
-    body: str
-    type: str
-    human_change_status: HumanChangeStatus
-    human_change_version: int = Field(ge=1)
-    last_human_changed_at: datetime
-    last_agent_viewed_at: datetime | None = None
-    last_agent_reviewed_at: datetime | None = None
-    audit_events: list[KnowledgeAuditRecord] = Field(default_factory=list)
-
-
-class KnowledgeHumanChangeSearchResult(StrictModel):
-    items: list[KnowledgeHumanChangeItem] = Field(default_factory=list)
-
-
-class KnowledgeAssignmentRecord(StrictModel):
-    id: str
-    item_id: str
-    item_kind: KnowledgeItemKind
-    project_id: str
-    previous_project_id: str | None = None
-    reason: str
-    created_at: datetime
-    updated_at: datetime

package/graph-provider/fuli_graph/project_agent_context_models.py

@@ -0,0 +1,29 @@
+"""Read-only task-entry selection; never submits a task or spawns a worker."""
+
+from typing import Literal
+
+from pydantic import Field
+
+from .models import SourceApplication, StrictModel
+from .project_agent_memory_models import MemoryNote
+from .project_agent_models import ProjectAgentRecord
+
+
+class ProjectAgentContextRequest(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    personal_project_id: str = Field(min_length=1, max_length=128)
+    agent_id: str | None = Field(default=None, min_length=1, max_length=128)
+    session_id: str | None = Field(default=None, min_length=1, max_length=256)
+    turn_id: str | None = Field(default=None, min_length=1, max_length=256)
+    work_kind: str = Field(default='project_context', min_length=1, max_length=128)
+    required_capabilities: list[MemoryNote] = Field(default_factory=list, max_length=16)
+    source_application: SourceApplication = 'other'
+
+
+class ProjectAgentContextResolution(StrictModel):
+    status: Literal['ready', 'manual_selection', 'unassigned', 'agent_unavailable']
+    reason: str
+    match_basis: list[str] = Field(default_factory=list)
+    candidate_count: int = 0
+    agent: ProjectAgentRecord | None = None
+    worker_started: Literal[False] = False

package/graph-provider/fuli_graph/project_agent_executor_models.py

@@ -11,7 +11,7 @@ import json
 from datetime import datetime
 from typing import Literal
 
-from pydantic import Field, field_validator, model_validator
+from pydantic import AwareDatetime, Field, field_validator, model_validator
 
 from .model_validation import reject_credentials
 from .models import SourceApplication, StrictModel
@@ -81,6 +81,26 @@ ProjectAgentExecutorTerminalOutcome = Literal[
     'cancelled',
 ]
 
+_CAPABILITY_ALIASES = {
+    'code': 'coding',
+    'development': 'coding',
+    'implementation': 'coding',
+    'software_development': 'coding',
+    'software_implementation': 'coding',
+    'test': 'testing',
+    'tests': 'testing',
+    'run_test': 'testing',
+    'run_tests': 'testing',
+    'test_execution': 'testing',
+}
+
+
+def project_agent_capability_key(value: str) -> str:
+    """Return one provider-neutral key for common capability vocabulary."""
+
+    key = '_'.join(value.casefold().replace('-', ' ').split())
+    return _CAPABILITY_ALIASES.get(key, key)
+
 
 def project_agent_model_strategy_key(
     strategy: ProjectAgentModelStrategy,
@@ -92,7 +112,10 @@ def project_agent_model_strategy_key(
     # Canonicalizing them prevents equivalent provider-neutral strategies from
     # creating separate evidence/aggregate buckets.
     payload['capability_hints'] = sorted(
-        (value.casefold() for value in payload.get('capability_hints', [])),
+        (
+            project_agent_capability_key(value)
+            for value in payload.get('capability_hints', [])
+        ),
     )
     encoded = json.dumps(
         payload,
@@ -210,7 +233,7 @@ class ProjectAgentExecutorPreflightReport(StrictModel):
         max_length=64,
     )
     reason: str | None = Field(default=None, min_length=1, max_length=2048)
-    checked_at: datetime
+    checked_at: AwareDatetime
     idempotency_key: str = Field(min_length=8, max_length=256)
     source_application: SourceApplication | None = None
     source_session_id: str | None = Field(default=None, min_length=1, max_length=256)
@@ -238,7 +261,7 @@ class ProjectAgentExecutorHealthReport(StrictModel):
     executor_id: str = Field(min_length=1, max_length=128)
     status: ProjectAgentExecutorHealthStatus
     reason: str | None = Field(default=None, min_length=1, max_length=2048)
-    checked_at: datetime
+    checked_at: AwareDatetime
     idempotency_key: str = Field(min_length=8, max_length=256)
     source_application: SourceApplication | None = None
     source_session_id: str | None = Field(default=None, min_length=1, max_length=256)
@@ -277,6 +300,7 @@ class ProjectAgentExecutorRecord(StrictModel):
 
 
 class ProjectAgentExecutorPriorityUpdate(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
     executor_id: str = Field(min_length=1, max_length=128)
     global_priority: int = Field(ge=1, le=1_000_000)
     expected_revision: int = Field(ge=0)
@@ -453,7 +477,7 @@ class ProjectAgentExecutorActualReport(StrictModel):
     matched_rule_id: str | None = Field(default=None, min_length=1, max_length=128)
     fallback_reason: str | None = Field(default=None, min_length=1, max_length=2048)
     idempotency_key: str = Field(min_length=8, max_length=256)
-    occurred_at: datetime
+    occurred_at: AwareDatetime
     source_application: SourceApplication | None = None
     source_session_id: str | None = Field(default=None, min_length=1, max_length=256)
 
@@ -486,7 +510,7 @@ class ProjectAgentExecutorOutcomeEvidenceCreate(StrictModel):
     reference_ids: list[str] = Field(default_factory=list, max_length=16)
     note: str | None = Field(default=None, min_length=1, max_length=2048)
     idempotency_key: str = Field(min_length=8, max_length=256)
-    occurred_at: datetime
+    occurred_at: AwareDatetime
 
     @field_validator('reference_ids')
     @classmethod
@@ -537,6 +561,9 @@ class ProjectAgentExecutorOutcomeEvidenceRecord(
     # contract keeps this optional for backwards-compatible callers; the store
     # computes it before returning a durable record.
     model_strategy_key: str = Field(min_length=64, max_length=64)
+    # Legacy unknown-timezone records remain inspectable/ignorable; new writes
+    # require an explicit offset and must not guess the caller's local zone.
+    occurred_at: datetime
     evidence_id: str
     ignored: bool = False
     ignored_reason: str | None = None
@@ -579,6 +606,7 @@ class ProjectAgentExecutorOutcomeAggregate(StrictModel):
     evidence_contributions: list[ProjectAgentExecutorEvidenceContribution] = Field(
         default_factory=list
     )
+    validation_warnings: list[str] = Field(default_factory=list)
 
     @model_validator(mode='after')
     def validate_strategy_key(self):
@@ -619,7 +647,7 @@ class ProjectAgentExecutorOutcomeReset(StrictModel):
     )
     reason: str = Field(min_length=1, max_length=2048)
     idempotency_key: str = Field(min_length=8, max_length=256)
-    reset_at: datetime
+    reset_at: AwareDatetime
 
     @model_validator(mode='after')
     def reject_sensitive_values(self):

package/graph-provider/fuli_graph/project_agent_memory_models.py

@@ -0,0 +1,79 @@
+"""Provider-neutral contracts for private Agent working context.
+
+Working notes are not confirmed project knowledge or user preferences. Their
+scope and revision travel with every response, regardless of the calling host.
+"""
+
+from datetime import datetime
+import json
+from typing import Annotated, Literal
+
+from pydantic import Field, StringConstraints, model_validator
+
+from .model_validation import reject_credentials
+from .models import SourceApplication, StrictModel
+
+
+MemoryNote = Annotated[
+    str, StringConstraints(strip_whitespace=True, min_length=1, max_length=1024)
+]
+
+
+class ProjectAgentWorkingMemory(StrictModel):
+    summary: Annotated[
+        str, StringConstraints(strip_whitespace=True, min_length=1, max_length=4000)
+    ]
+    decisions: list[MemoryNote] = Field(default_factory=list, max_length=12)
+    open_threads: list[MemoryNote] = Field(default_factory=list, max_length=12)
+    next_actions: list[MemoryNote] = Field(default_factory=list, max_length=12)
+
+    @model_validator(mode='after')
+    def reject_sensitive_values(self):
+        reject_credentials(self, 'Agent working memory')
+        if len(json.dumps(self.model_dump(), ensure_ascii=False).encode()) > 32 * 1024:
+            raise ValueError('Agent working memory must fit within 32 KiB; distill the notes')
+        return self
+
+
+class ProjectAgentMemoryWrite(StrictModel):
+    personal_space_id: str = Field(min_length=1, max_length=128)
+    personal_project_id: str = Field(min_length=1, max_length=128)
+    agent_id: str = Field(min_length=1, max_length=128)
+    expected_revision: int = Field(ge=0)
+    idempotency_key: str = Field(min_length=8, max_length=256)
+    memory: ProjectAgentWorkingMemory
+    source_application: SourceApplication
+    source_session_id: str | None = Field(default=None, min_length=1, max_length=256)
+    task_id: str | None = Field(default=None, min_length=1, max_length=128)
+
+    @model_validator(mode='after')
+    def reject_sensitive_values(self):
+        reject_credentials(self, 'Agent memory checkpoint')
+        return self
+
+
+class ProjectAgentMemoryRecord(StrictModel):
+    checkpoint_id: str
+    personal_space_id: str
+    personal_project_id: str
+    agent_id: str
+    revision: int = Field(ge=1)
+    memory: ProjectAgentWorkingMemory
+    source_application: SourceApplication
+    source_session_id: str | None = None
+    task_id: str | None = None
+    created_at: datetime
+
+
+class ProjectAgentMemoryView(StrictModel):
+    personal_space_id: str
+    personal_project_id: str
+    agent_id: str
+    scope: Literal['private_agent_project'] = 'private_agent_project'
+    storage: Literal['neo4j'] = 'neo4j'
+    authority: Literal['working_context_not_confirmed_knowledge'] = (
+        'working_context_not_confirmed_knowledge'
+    )
+    revision: int = Field(default=0, ge=0)
+    current: ProjectAgentMemoryRecord | None = None
+    history: list[ProjectAgentMemoryRecord] = Field(default_factory=list)