Yj0dZddlmZddlZddlmZmZddlmZddl m Z m Z ddl m Z dd lmZdd lmZdd lmZer dd lmZdd lmZgdZGddeZGddZGddZdS)z6Conclusion types and scoped access for the Honcho SDK.) annotationsN) TYPE_CHECKINGAny) BaseModel)ConclusionResponseRepresentationResponse) SessionBase)routes)SyncPage) resolve_idConclusionScopeAio)Honcho) ConclusionConclusionScopeConclusionCreateParamsc(eZdZUded<dZded<dS)rstrcontentN str | None session_id)__name__ __module__ __qualname____annotations__rY/home/ubuntu/.hermes/hermes-agent/venv/lib/python3.11/site-packages/honcho/conclusions.pyrrs,LLL!J!!!!!!rrceZdZUdZded<ded<ded<ded<dZded <d ed <ddZeddZddZ ddZ dS)ra A conclusion from Honcho's reasoning system. Conclusions are facts derived from messages that help build a representation of a peer. Attributes: id: Unique identifier for this conclusion content: The conclusion content/text observer_id: The peer ID who made this conclusion observed_id: The peer ID this conclusion is about session_id: The session this conclusion relates to created_at: Timestamp for when the conclusion was created ridr observer_id observed_idNrrdatetime.datetime created_atreturnNonecZ||_||_||_||_||_||_dSNr!rr"r#rr%)selfr!rr"r#rr%s r__init__zConclusion.__init__8s4 &&$$rdatar 'Conclusion'c`||j|j|j|j|j|jS)z)Create a Conclusion from an API response.r*r*)clsr-s rfrom_api_responsezConclusion.from_api_responseHs=swL((     rct|jdkr|jdddn|j}d|jd|dS)N2z...zConclusion(id='z ', content='z'))lenrr!)r+ truncateds r__repr__zConclusion.__repr__TsW),T\):):R)?)?t|CRC % % % %T\ DCCiCCCCrc|jSr))rr+s r__str__zConclusion.__str__Zs |r)r!rrrr"rr#rrrr%r$r&r')r-rr&r.r&r) rrr__doc__rrr, classmethodr1r6r9rrrrr!s   GGGLLL!J!!!!!!!!%%%%     [  DDDD rrceZdZUdZded<ded<ded<ded<d.d Zed/d Z d0d1dZ d2d3dZ d4d Z d5d#Z d6d7d,Z d8d-Z dS)9raK Scoped access to conclusions for a specific observer/observed relationship. This class provides convenient methods to list, query, create, and delete conclusions that are automatically scoped to a specific observer/observed pair. Typically accessed via `peer.conclusions` (for self-conclusions) or `peer.conclusions_of(target)` (for conclusions about another peer). Example: ```python # Get self-conclusions conclusions = peer.conclusions obs_list = conclusions.list() search_results = conclusions.query("preferences") # Get conclusions about another peer bob_conclusions = peer.conclusions_of("bob") bob_list = bob_conclusions.list() # Async operations via .aio accessor obs_list = await peer.conclusions.aio.list() ``` 'Honcho'_honchor workspace_idobserverobservedhonchoc>||_||_||_||_dS)z Initialize a ConclusionScope. Args: honcho: The Honcho client instance workspace_id: The workspace ID observer: The observer peer ID observed: The observed peer ID N)r?r@rArB)r+rCr@rArBs rr,zConclusionScope.__init__}s%  (    rr&'ConclusionScopeAio'c$ddlm}||S)a Access async versions of all ConclusionScope methods. Returns a ConclusionScopeAio view that provides async versions of all methods while sharing state with this ConclusionScope instance. Example: ```python # Async operations obs_list = await scope.aio.list() results = await scope.aio.query("preferences") ``` rr)aior)r+rs rrGzConclusionScope.aios' ,+++++!!$'''rrr3Npageintsizesessionstr | SessionBase | None(SyncPage[ConclusionResponse, Conclusion]cNjt|}jjd|r|d<jjtjj di|d}dd dfd t|tS)a7 List conclusions in this scope. Args: page: Page number (1-indexed) size: Number of results per page session: Optional session (ID string or Session object) to filter by Returns: Paginated response containing Conclusion objects r"r#rfiltersrHrJbodyqueryresponserr&rc6t|Sr))rr1)rUs r transformz'ConclusionScope.list..transforms//99 9rrHrIrMcjjtjjdi|d}t |tS)NrPrQrR)r?_httppostr conclusions_listr@r r)rH next_data fetch_nextrPr+rJrWs rr]z(ConclusionScope.list..fetch_nexts_ *//'(9::)#T220I I'99jQQ Qr)rUrr&r)rHrIr&rM) r?_ensure_workspacer rArBrYrZr r[r@r r) r+rHrJrKresolved_session_idr-r]rPrWs ` ` @@@rlistzConclusionScope.lists" &&((((11==# #   8$7GL !|!&&  #D$5 6 6W%..'    : : : : R R R R R R R R R R0)ZHHHr rTtop_kdistance float | Nonelist[Conclusion]c|j|j|jd}|||d}|||d<|jjt j|j|}d|DS)a5 Semantic search for conclusions in this scope. Args: query: The search query string top_k: Maximum number of results to return distance: Maximum cosine distance threshold (0.0-1.0) Returns: List of matching Conclusion objects rO)rTrbrPNrcrScfg|].}ttj|/Srrr1rmodel_validate.0items r z)ConclusionScope.query..B     ( ();)J4)P)P Q Q   r) r?r^rArBrYrZr conclusions_queryr@)r+rTrbrcrPrSr-s rrTzConclusionScope.querys" &&(((==# #      'D |!&&  $T%6 7 7'        r conclusion_idr'c|j|jjt j|j|dS)zy Delete a conclusion by ID. Args: conclusion_id: The ID of the conclusion to delete N)r?r^rYdeleter conclusionr@)r+rqs rrszConclusionScope.deletesG &&((( !!&"3D4E}"U"UVVVVVr conclusions-list[ConclusionCreateParams | dict[str, Any]]cjd fd fd|D}jjt jjd|i}d |DS) ag Create conclusions in this scope. Args: conclusions: List of conclusions to create. Each conclusion can be a ConclusionCreateParams object or a dictionary with a required 'content' key and an optional 'session_id' key. Returns: List of created Conclusion objects Example: ```python conclusions = peer.conclusions.create([ {"content": "User prefers dark mode", "session_id": "session1"}, {"content": "User is interested in AI"}, ]) ``` rm'ConclusionCreateParams | dict[str, Any]r&dict[str, Any]cjjd}t|tr|j|d<|j |j|d<|S|d|d<|d}|||d<|S)a Build a single conclusion create payload. This normalizes both `ConclusionCreateParams` instances and plain dictionaries into the wire format expected by the Honcho API. Notes: - `content` is required. - `session_id` is optional; when not provided it is omitted from the payload. - `observer_id` and `observed_id` are always injected from this scope. Args: item: A `ConclusionCreateParams` instance or a dict with a required `content` key and an optional `session_id` key. Returns: A dictionary suitable for inclusion in the `conclusions` array for the create conclusions endpoint. rOrNr)rArB isinstancerrrget)rmpayloadrr+s rbuild_conclusion_payloadz8ConclusionScope.create..build_conclusion_payload s. $}#}''G$ 677 %)\ "?.,0OGL)!%iGI ,//J%(2 %Nrc&g|] }|Srr)rlcr~s rrnz*ConclusionScope.create..Fs%NNNQ55a88NNNrrurgcfg|].}ttj|/Srrirks rrnz*ConclusionScope.create..Lror)rmrxr&ry)r?r^rYrZr rur@)r+ruconclusion_paramsr-r~s` @rcreatezConclusionScope.creates. &&((($ $ $ $ $ $ LONNN+NNN|!&&  t0 1 1!23'        r search_queryr search_top_k int | Nonesearch_max_distanceinclude_most_frequent bool | Nonemax_conclusionsc>|jd|ji}|||d<|||d<|||d<|||d<|||d<|jjt j|j|j|}tj |}|j S) a Get the computed representation for this scope. This returns the working representation (narrative) built from the conclusions in this scope. Args: search_query: Optional semantic search query to curate the representation search_top_k: Number of semantically relevant facts to return search_max_distance: Maximum semantic distance for search results (0.0-1.0) include_most_frequent: Whether to include the most frequent conclusions max_conclusions: Maximum number of conclusions to include Returns: A Representation string targetNrrrrrrg) r?r^rBrYrZr peer_representationr@rAr rjrepresentation) r+rrrrrrSr-rUs rrzConclusionScope.representationQs0 &&((( ($-8  ##/D  ##/D  **=D& ' ,,AD( )  &&5D" #|!&&  &t'8$- H H'  *8>>&&rc8d|jd|jd|jdS)NzConclusionScope(workspace_id=z , observer=z , observed=))r@rArBr8s rr6zConclusionScope.__repr__}sF GD,= G G  G G48M G G G r)rCr>r@rrArrBr)r&rE)rr3N)rHrIrJrIrKrLr&rM)raN)rTrrbrIrcrdr&re)rqrr&r')rurvr&re)NNNNN) rrrrrrdrrrrr&rr:)rrrr;rr,propertyrGr`rTrsrrr6rrrrr^s<2MMMMMM!!!!*(((X(*,0 -I-I-I-I-Id!% & & & & & PWWWWH H H H X$(#',0-1&* *'*'*'*'*'X      rr)r; __future__rdatetimetypingrrpydanticr api_typesrr baser httpr paginationr utilsr rGrclientr__all__rrrrrrrs|<<""""""%%%%%%%%AAAAAAAA ''''''   """""Y""" ::::::::zc c c c c c c c c c r