RmjN dZddlZddlmZgdZejdZdefdZdedefd Z d ededzfd Z d ededzde fd Z d ededzde fd Z dS)a Session scoping for experimental task identifiers. Task IDs generated by `run_task()` embed an opaque, per-session marker (the "session scope") so that the default task handlers can tell which session created a task. The default handlers for tasks/get, tasks/result, tasks/list, and tasks/cancel only operate on tasks created by the requesting session. Task IDs without a session scope (explicitly provided IDs, IDs created directly through a TaskStore, or IDs created in stateless mode) have no known creator. They can be used with tasks/get, tasks/result, and tasks/cancel from any session - possession of the ID is what grants access - but they are never included in tasks/list responses. WARNING: These APIs are experimental and may change without notice. Nuuid4)new_session_scopescoped_task_idsession_scope_oftask_in_session_scopetask_listable_in_session_scopezX\A(?P[0-9a-f]{32}):[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\Zreturnc(tjS)z(Create a new opaque session scope token.)rhexj/home/thesage/.hermes/hermes-agent/venv/lib/python3.11/site-packages/mcp/server/experimental/task_scope.pyrr&s 77;r session_scopec(|dtS)z;Generate a task ID associated with the given session scope.:r)rs rrr+s ' 'egg ' ''rtask_idcht|}|r|dndS)zGReturn the session scope embedded in a task ID, or None if it has none.scopeN)_SCOPED_TASK_IDmatchgroup)rrs rrr0s1  ! !' * *E#( 25;;w   d2rc4t|}|dup||kS)a!Whether a task may be used by a requestor with the given session scope. Used by tasks/get, tasks/result, and tasks/cancel. A task whose ID carries no session scope has no known creator, so possession of the ID is what grants access to it: it can be used from any session. Nrrrembeddeds rrr6s& ((H t  8x=88rc4t|}|duo||kS)aWhether a task may be included in a tasks/list response for the given session scope. Used by tasks/list. Listing is stricter than access by ID: a task is only listed to the session that created it. Tasks with no session scope are never listed because they have no known creator, and requestors with no session scope are never shown any tasks because the server cannot tell them apart. Nrrs rr r As& ((H 4  =H $==r)__doc__reuuidr__all__compilerstrrrrboolrr r rrr%s"    "*F 3 (#(#(((( 3c3cDj3333 939sTz9d9999 >C >d >t > > > > > >r