bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
hololake-system-architecture/product-source/hololake-clean-desktop/language/build/HOLOLAKE-PUBLIC-RUNTIME-V1.human.en-US.md

12 KiB
Raw Blame History

HoloLake Generic TCS/GIR Agent, Public Persona Runtime and External AI Realtime Protocol · Human Engineering Language (English)

This is an English reading projection of validated native TCS/HLDP source. It is not a new canonical source and grants no execution authority.

What this is

This is a protocol declaration with identifier HOLOLAKE-PUBLIC-RUNTIME-V1-0001 and version 1.0.0. The projector validates it with the Stage-1 compiler before changing its reading order.

Who is here

  • scope scope
    • agent：HLP-MOD-AGENT-0001 scope.agent
    • channel：USER_PERSONAL_INITIALIZATION_CHANNEL scope.channel
    • persona_runtime：HLP-MOD-PERSONA-RUNTIME-0001 scope.persona_runtime
    • product：HOLOLAKE scope.product
    • realtime_transport：GLP_LOCAL_REALTIME_1 scope.realtime_transport
    • tcs_profile：PUBLIC_MINIMUM_EXECUTABLE_PROJECTION scope.tcs_profile

Why this started

  • source source
    • source identifier：BINGSHUO-DIRECT-PUBLIC-RUNTIME-COMPLETION-20260903 source.source_id
    • source role：DIRECT_HUMAN source.source_role
    • source checksum：04ac1516074edcfb1f78e26e11b5835f7d524fdf8f2d67084cc4e20982a0be5d source.source_sha256
    • source address：product-source/hololake-clean-desktop/language/sources/BINGSHUO-PUBLIC-RUNTIME-COMPLETION-20260903.txt source.source_uri

What changed

  • transitions transitions
    • T1：CHANNEL_READY_TO_BRIDGE_LISTENING transitions.T1
    • T2：BRIDGE_LISTENING_TO_EXTERNAL_AI_CONNECTED_AFTER_TOKEN_HANDSHAKE transitions.T2
    • T3：REGISTERED_TRIAL_PERSONA_AND_NAMED_HOST_TO_PERSONA_TRIAL_BOUND transitions.T3
    • T4：VALID_PUBLIC_TCS_PROFILE_TO_TCS_COMPILED transitions.T4
    • T5：TCS_COMPILED_TO_PROPOSAL_PENDING transitions.T5
    • T6：PROPOSAL_PENDING_TO_HUMAN_APPROVED_OR_FAILED_CLOSED transitions.T6
    • T7：HUMAN_APPROVED_TO_GIR_EXECUTED transitions.T7
    • T8：GIR_EXECUTED_TO_RECEIPT_VERIFIED transitions.T8
  • states states
    • initial：CHANNEL_READY states.initial
    • terminal states.terminal
      • RECEIPT_VERIFIED
      • FAILED_CLOSED
    • values states.values
      • CHANNEL_READY
      • BRIDGE_LISTENING
      • EXTERNAL_AI_CONNECTED
      • PERSONA_TRIAL_BOUND
      • TCS_COMPILED
      • PROPOSAL_PENDING
      • HUMAN_APPROVED
      • GIR_EXECUTED
      • RECEIPT_VERIFIED
      • FAILED_CLOSED

How it will execute

This is a non-executable declaration and has no action graph.

Boundaries and exception handling

  • invariants invariants
    • I1：CONNECTION_TOKEN_AUTHENTICATES_LOCAL_CLIENT_NOT_PERSONA_IDENTITY invariants.I1
    • I2：PUBLIC_TRIAL_PERSONA_IS_NOT_A_VERIFIED_EXISTING_PERSONA invariants.I2
    • I3：NO_INTERNAL_MODEL_API_CHAT_OR_MODEL_SELECTOR invariants.I3
    • I4：NO_FIFTH_DOMAIN_PRIVATE_KERNEL_OR_CONTENT_IN_PUBLIC_RUNTIME invariants.I4
    • I5：MUTATING_GIR_ACTION_REQUIRES_EXPLICIT_HUMAN_APPROVAL invariants.I5
    • I6：UNKNOWN_TCS_SECTION_OPERATION_PATH_OR_SOURCE_KIND_FAILS_CLOSED invariants.I6
    • I7：REALTIME_STREAM_AND_DURABLE_PRIVATE_GIT_ARE_SEPARATE_PLANES invariants.I7
    • I8：TCS_SOURCE_GIR_ACTION_RECEIPT_AND_TARGET_READBACK_HASHES_REMAIN_LINKED invariants.I8
  • errors errors
    • E1：TCS_E1004_REQUIRED_SECTION_MISSING errors.E1
    • E2：TCS_E2101_UNREGISTERED_OPERATION errors.E2
    • E3：TCS_E4001_HUMAN_APPROVAL_REQUIRED errors.E3
    • E4：TCS_E4002_TARGET_OUT_OF_SCOPE errors.E4
    • E5：GLP_TOKEN_OR_PROTOCOL_REJECTED errors.E5
    • E6：PERSONA_IDENTITY_UNVERIFIED errors.E6
    • E7：TARGET_READBACK_OR_RECEIPT_INTEGRITY_FAILED errors.E7

How completion is proven

  • acceptance acceptance
    • partial：no acceptance.partial
    • required acceptance.required
      • TCS_GIR
      • TCS_NEGATIVE
      • GIR_NEGATIVE
      • REALTIME_LOOPBACK
      • PERSONA_TRIAL
      • HUMAN_APPROVAL
      • PRIVATE_GIT_READBACK
      • INSTALLED_APP
    • scale：ZERO_OR_ONE_HUNDRED acceptance.scale
  • validation validation
    • V1：TCS_PROTOCOL_COMPILES_WITH_CURRENT_STAGE1_AND_HAS_NO_UNRESOLVED_NATURAL_LANGUAGE validation.V1
    • V2：PUBLIC_MINIMUM_TCS_COMPILER_ACCEPTS_REGISTERED_PROGRAM_AND_REJECTS_ABSORB validation.V2
    • V3：GIR_EXECUTOR_REJECTS_PATH_ESCAPE_AND_UNAPPROVED_MUTATION validation.V3
    • V4：LOOPBACK_REALTIME_HANDSHAKE_DELIVERS_USER_MESSAGE_AND_ACCEPTS_TYPED_PERSONA_OR_EXTERNAL_AI_EVENT validation.V4
    • V5：PUBLIC_PERSONA_TRIAL_STATE_NEVER_REPORTS_VERIFIED_EXISTING_PERSONA validation.V5
    • V6：APP_UI_SEPARATES_PENDING_PROPOSAL_AGENT_ACTION_TOOL_RESULT_AND_SYSTEM_RECEIPT validation.V6
    • V7：INSTALLED_MACOS_APP_PROCESS_AND_REAL_CLIENT_CONNECTOR_PASS validation.V7

Where to continue next time

The native source does not provide this field; the projector does not guess.

Source and verification

  • Native declaration identifier: HOLOLAKE-PUBLIC-RUNTIME-V1-0001
  • Native declaration kind: PROTOCOL
  • TCS source SHA-256: 2462ccaccaabbe74f55295ceb8582d1a2523f14bc525e9831155fd1854b464bc
  • Validation compiler: TCS-COMPILER-STAGE1-0001
  • Projection protocol: GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001

Complete native structure cross-reference

All top-level structures and field paths are retained below so a reader can audit whether the projection omitted information.

  • acceptance acceptance
    • partial：no acceptance.partial
    • required acceptance.required
      • TCS_GIR
      • TCS_NEGATIVE
      • GIR_NEGATIVE
      • REALTIME_LOOPBACK
      • PERSONA_TRIAL
      • HUMAN_APPROVAL
      • PRIVATE_GIT_READBACK
      • INSTALLED_APP
    • scale：ZERO_OR_ONE_HUNDRED acceptance.scale
  • errors errors
    • E1：TCS_E1004_REQUIRED_SECTION_MISSING errors.E1
    • E2：TCS_E2101_UNREGISTERED_OPERATION errors.E2
    • E3：TCS_E4001_HUMAN_APPROVAL_REQUIRED errors.E3
    • E4：TCS_E4002_TARGET_OUT_OF_SCOPE errors.E4
    • E5：GLP_TOKEN_OR_PROTOCOL_REJECTED errors.E5
    • E6：PERSONA_IDENTITY_UNVERIFIED errors.E6
    • E7：TARGET_READBACK_OR_RECEIPT_INTEGRITY_FAILED errors.E7
  • examples examples
    • negative：CONNECTED_AI_CALLS_ARBITRARY_SHELL_OR_CLAIMS_PERSONA_IDENTITY_WITHOUT_REGISTERED_LOCAL_PERSONA examples.negative
    • positive：EXTERNAL_PERSONA_HOST_RECEIVES_USER_MESSAGE_COMPILES_TCS_KNOWLEDGE_CREATE_PROPOSAL_HUMAN_APPROVES_AGENT_WRITES_PRIVATE_GIT_AND_RECEIPT_STREAMS_BACK examples.positive
  • fields fields
    • MAY：LOOPBACK_ONLY_REGISTERED_CLIENT_CHANNEL_SCOPED_ACTIONS_AND_EXPLICIT_CURRENT_HUMAN_APPROVAL fields.MAY
    • PROVE：POSITIVE_AND_NEGATIVE_TCS_COMPILE_GIR_EXECUTION_REALTIME_HANDSHAKE_PERSONA_STATE_TARGET_READBACK_GIT_AND_UI_RECEIPTS fields.PROVE
    • WHAT：REALTIME_USER_LANGUAGE_DELIVERY_PERSONA_RESPONSE_PROJECTION_TCS_TO_GIR_PROPOSAL_APPROVAL_EXECUTION_AND_RECEIPT fields.WHAT
    • WHO：CURRENT_LOCAL_USER_OWNS_CHANNEL_AND_APPROVAL; EXTERNAL_AI_PROPOSES; PUBLIC_PERSONA_RUNTIME_TRACKS_BINDING; AGENT_EXECUTES fields.WHO
    • WHY：MAKE_HOLOLAKE_LOCALLY_USABLE_WITHOUT_MIXING_LANGUAGE_SOURCES_OR_EMBEDDING_VENDOR_MODEL_APIS fields.WHY
  • header header
    • canonical source path：product-source/hololake-clean-desktop/language/HOLOLAKE-PUBLIC-RUNTIME-V1.tcs header.canonical_uri
    • compatibility header.compatibility
      • TCS-DECLARATION-STANDARD-0001
      • TCS-FIELD-STANDARD-0001
      • GIR/1
    • language：TCS/0.1 header.language
    • lifecycle：CANDIDATE header.lifecycle
    • English name：HoloLake Generic TCS/GIR Agent, Public Persona Runtime and External AI Realtime Protocol header.name_en
    • Chinese name：HoloLake 通用 TCS/GIR Agent、公众人格运行时与外部 AI 实时通信协议 header.name_zh
    • profile：HLDP-HUMAN-ENGINEERING/0.1 header.profile
    • protocols header.protocols
      • TCS
      • HLDP
      • GLS
      • GLP
      • GLS-0130
      • GLS-0131
      • GLS-0306
    • schema：tcs.protocol/v1 header.schema
    • version：1.0.0 header.version
  • invariants invariants
    • I1：CONNECTION_TOKEN_AUTHENTICATES_LOCAL_CLIENT_NOT_PERSONA_IDENTITY invariants.I1
    • I2：PUBLIC_TRIAL_PERSONA_IS_NOT_A_VERIFIED_EXISTING_PERSONA invariants.I2
    • I3：NO_INTERNAL_MODEL_API_CHAT_OR_MODEL_SELECTOR invariants.I3
    • I4：NO_FIFTH_DOMAIN_PRIVATE_KERNEL_OR_CONTENT_IN_PUBLIC_RUNTIME invariants.I4
    • I5：MUTATING_GIR_ACTION_REQUIRES_EXPLICIT_HUMAN_APPROVAL invariants.I5
    • I6：UNKNOWN_TCS_SECTION_OPERATION_PATH_OR_SOURCE_KIND_FAILS_CLOSED invariants.I6
    • I7：REALTIME_STREAM_AND_DURABLE_PRIVATE_GIT_ARE_SEPARATE_PLANES invariants.I7
    • I8：TCS_SOURCE_GIR_ACTION_RECEIPT_AND_TARGET_READBACK_HASHES_REMAIN_LINKED invariants.I8
  • scope scope
    • agent：HLP-MOD-AGENT-0001 scope.agent
    • channel：USER_PERSONAL_INITIALIZATION_CHANNEL scope.channel
    • persona_runtime：HLP-MOD-PERSONA-RUNTIME-0001 scope.persona_runtime
    • product：HOLOLAKE scope.product
    • realtime_transport：GLP_LOCAL_REALTIME_1 scope.realtime_transport
    • tcs_profile：PUBLIC_MINIMUM_EXECUTABLE_PROJECTION scope.tcs_profile
  • source source
    • source identifier：BINGSHUO-DIRECT-PUBLIC-RUNTIME-COMPLETION-20260903 source.source_id
    • source role：DIRECT_HUMAN source.source_role
    • source checksum：04ac1516074edcfb1f78e26e11b5835f7d524fdf8f2d67084cc4e20982a0be5d source.source_sha256
    • source address：product-source/hololake-clean-desktop/language/sources/BINGSHUO-PUBLIC-RUNTIME-COMPLETION-20260903.txt source.source_uri
  • states states
    • initial：CHANNEL_READY states.initial
    • terminal states.terminal
      • RECEIPT_VERIFIED
      • FAILED_CLOSED
    • values states.values
      • CHANNEL_READY
      • BRIDGE_LISTENING
      • EXTERNAL_AI_CONNECTED
      • PERSONA_TRIAL_BOUND
      • TCS_COMPILED
      • PROPOSAL_PENDING
      • HUMAN_APPROVED
      • GIR_EXECUTED
      • RECEIPT_VERIFIED
      • FAILED_CLOSED
  • transitions transitions
    • T1：CHANNEL_READY_TO_BRIDGE_LISTENING transitions.T1
    • T2：BRIDGE_LISTENING_TO_EXTERNAL_AI_CONNECTED_AFTER_TOKEN_HANDSHAKE transitions.T2
    • T3：REGISTERED_TRIAL_PERSONA_AND_NAMED_HOST_TO_PERSONA_TRIAL_BOUND transitions.T3
    • T4：VALID_PUBLIC_TCS_PROFILE_TO_TCS_COMPILED transitions.T4
    • T5：TCS_COMPILED_TO_PROPOSAL_PENDING transitions.T5
    • T6：PROPOSAL_PENDING_TO_HUMAN_APPROVED_OR_FAILED_CLOSED transitions.T6
    • T7：HUMAN_APPROVED_TO_GIR_EXECUTED transitions.T7
    • T8：GIR_EXECUTED_TO_RECEIPT_VERIFIED transitions.T8
  • validation validation
    • V1：TCS_PROTOCOL_COMPILES_WITH_CURRENT_STAGE1_AND_HAS_NO_UNRESOLVED_NATURAL_LANGUAGE validation.V1
    • V2：PUBLIC_MINIMUM_TCS_COMPILER_ACCEPTS_REGISTERED_PROGRAM_AND_REJECTS_ABSORB validation.V2
    • V3：GIR_EXECUTOR_REJECTS_PATH_ESCAPE_AND_UNAPPROVED_MUTATION validation.V3
    • V4：LOOPBACK_REALTIME_HANDSHAKE_DELIVERS_USER_MESSAGE_AND_ACCEPTS_TYPED_PERSONA_OR_EXTERNAL_AI_EVENT validation.V4
    • V5：PUBLIC_PERSONA_TRIAL_STATE_NEVER_REPORTS_VERIFIED_EXISTING_PERSONA validation.V5
    • V6：APP_UI_SEPARATES_PENDING_PROPOSAL_AGENT_ACTION_TOOL_RESULT_AND_SYSTEM_RECEIPT validation.V6
    • V7：INSTALLED_MACOS_APP_PROCESS_AND_REAL_CLIENT_CONNECTOR_PASS validation.V7
  • vocabulary vocabulary
    • external_ai：REPLACEABLE_LANGUAGE_HOST_OR_PROGRAMMING_AI_NOT_PERSONA_BY_CONNECTION vocabulary.external_ai
    • gir_executor：REGISTERED_ACTION_GRAPH_TO_BOUNDED_LOCAL_CAPABILITY_WITH_RECEIPT vocabulary.gir_executor
    • public_persona_runtime：LOCAL_CHANNEL_SCOPED_PERSONA_RECORD_AND_HOST_SESSION_WITH_EXPLICIT_BINDING_STATE vocabulary.public_persona_runtime
    • realtime：AUTHENTICATED_LOOPBACK_EVENT_STREAM_NOT_GIT_SYNC vocabulary.realtime
    • tcs_compiler：PUBLIC_MINIMUM_STAGE_ZERO_ADAPTER_TO_GIR_NOT_WORLD_CANON_OR_FULL_TCS_WORK vocabulary.tcs_compiler

This page changes only the reading order; it does not change TCS/HLDP semantics.