JiuwenMemory 0.0.1__py3-none-any.whl

jiuwen_memory/__init__.py

@@ -0,0 +1 @@
+# Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.

jiuwen_memory/api/__init__.py

@@ -0,0 +1,171 @@
+# Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.
+"""记忆接口层（B 层，§9）：统一 Core API（形态无关）。
+
+调用层（``jiuwen_memory_entry/``、``jiuwen_memory_adapter/``）只依赖本包：这里重导出
+调用所需的全部类型，调用方无需 import 内核其他包。
+"""
+
+from jiuwen_memory.common.errors import (
+    AgentMemoryError,
+    AuthenticationError,
+    ConflictError,
+    NotFoundError,
+    PartialFailureError,
+    PermissionDeniedError,
+    PolicyError,
+    RateLimitedError,
+    UnsupportedCapabilityError,
+    ValidationError,
+    safe_error_message,
+)
+from jiuwen_memory.common.log import (
+    install_privacy_filter,
+    metadata_for_log,
+    redact_for_log,
+    scope_for_log,
+)
+from jiuwen_memory.common.security.legacy import legacy_request_context
+from jiuwen_memory.common.security.request_context import (
+    get_request_id,
+    new_request_context,
+    reset_request_id,
+    set_request_id,
+)
+from jiuwen_memory.common.security.types import (
+    Action,
+    Credentials,
+    Grant,
+    RequestSecurityContext,
+    Surface,
+    reset_current,
+    set_current,
+)
+from jiuwen_memory.common.type_def import (
+    EXT_MAX_TOKENS,
+    AuditEvent,
+    Context,
+    FilterClause,
+    FilterExpr,
+    FilterOp,
+    LifecycleState,
+    MemoryTier,
+    MemoryUnit,
+    Modality,
+    Scope,
+    Segment,
+)
+from jiuwen_memory.construction import EvolveMode
+from jiuwen_memory.control import (
+    BatchWriteItem,
+    BatchWriteOutcome,
+    BatchWriteResult,
+    Channel,
+    DeleteMode,
+    DeleteSelector,
+    IngestSubmission,
+    JobInfo,
+    JobStatus,
+    MemoryListResult,
+    MemoryPatch,
+    PrincipalPath,
+    SpaceDeleteResult,
+    SpaceInfo,
+    SpaceMember,
+    SpacePatch,
+    SpacePolicy,
+    SpaceSpec,
+    SpaceStatus,
+    SpaceUsage,
+    UpdateMode,
+)
+from jiuwen_memory.retrieval import (
+    DisclosureLevel,
+    RetrievalResult,
+    RetrievedItem,
+    TrajectoryStep,
+)
+
+from .access_security import build_dev_authenticator
+from .memory_api import MemoryAPI
+from .memory_api_impl import MemoryRuntime, assemble, assemble_runtime
+
+__all__ = [
+    "MemoryAPI",
+    "assemble",
+    "assemble_runtime",
+    "MemoryRuntime",
+    "build_dev_authenticator",
+    # 数据模型（common.type_def）
+    "Scope",
+    "Context",
+    "EXT_MAX_TOKENS",
+    "Modality",
+    "MemoryTier",
+    "LifecycleState",
+    "MemoryUnit",
+    "Segment",
+    # 写入/修正/删除（control）
+    "MemoryPatch",
+    "MemoryListResult",
+    "BatchWriteItem",
+    "BatchWriteOutcome",
+    "BatchWriteResult",
+    "UpdateMode",
+    "DeleteMode",
+    "DeleteSelector",
+    "PrincipalPath",
+    "SpaceStatus",
+    "SpacePolicy",
+    "SpaceSpec",
+    "SpaceInfo",
+    "SpacePatch",
+    "SpaceMember",
+    "SpaceUsage",
+    "SpaceDeleteResult",
+    # 检索（retrieval）
+    "DisclosureLevel",
+    "RetrievalResult",
+    "RetrievedItem",
+    "TrajectoryStep",
+    # 前置过滤（common.type_def）
+    "FilterClause",
+    "FilterExpr",
+    "FilterOp",
+    # 演进 + 任务调度（construction / control）
+    "EvolveMode",
+    "Channel",
+    "IngestSubmission",
+    "JobInfo",
+    "JobStatus",
+    # 治理 / 授权 / 请求安全上下文
+    "AuditEvent",
+    "Grant",
+    "Action",
+    "Credentials",
+    "RequestSecurityContext",
+    "Surface",
+    "legacy_request_context",
+    "new_request_context",
+    "reset_request_id",
+    "get_request_id",
+    "set_request_id",
+    "set_current",
+    "reset_current",
+    # Access 错误映射（公开异常，transport 不识别内核内部模块）
+    "AgentMemoryError",
+    "AuthenticationError",
+    "ConflictError",
+    "NotFoundError",
+    "PartialFailureError",
+    "PermissionDeniedError",
+    "PolicyError",
+    "RateLimitedError",
+    "UnsupportedCapabilityError",
+    "ValidationError",
+    "safe_error_message",
+    # Access 日志隐私能力（adapter 不直接依赖内核 common 包）
+    "install_privacy_filter",
+    "metadata_for_log",
+    "redact_for_log",
+    "scope_for_log",
+]

jiuwen_memory/api/access_security.py

@@ -0,0 +1,15 @@
+# Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.
+"""Access 层可用的安全能力装配辅助。"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+from jiuwen_memory.common.security.authentication.base import Authenticator
+from jiuwen_memory.common.security.authentication_impl import DevAuthenticator
+
+
+def build_dev_authenticator(*, identities: Mapping[str, Any] | None = None) -> Authenticator:
+    """构造固定身份或服务端预设身份认证器，仅供 HTTP / CLI 开发测试。"""
+    return DevAuthenticator(identities=identities)