(Gjh d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl m Z ddl
mZ ddlmZ ddlmZ ddlmZmZ dd lmZmZ dd
lmZ dd lm Z d Z d
Z ej dej Z! ej dej Z"dZ#dZ$dEdZ%dFdZ&dGdZ'dFdZ(dHd Z)dId#Z*dJd$Z+ dKdLd,Z,dMd.Z-dNd3Z.dOd7Z/dPd:Z0dQd>Z1 G d? d@ Z2 G dA dB Z3 G dC dD Z4dS )Rat OpenAI-compatible shim that forwards Hermes requests to `copilot --acp`.
This adapter lets Hermes treat the GitHub Copilot ACP server as a chat-style
backend. Each request starts a short-lived ACP session, sends the formatted
conversation as a single prompt, collects text chunks, and converts the result
back into the minimal shape Hermes expects from an OpenAI client.
) annotationsN)deque)Path)SimpleNamespace)Any ChatCompletionMessageToolCallFunction)get_read_block_erroris_write_denied)redact_sensitive_text)hermes_subprocess_envz
acp://copilotg @z&\s*(\{.*?\})\s*zd\{\s*\"id\"\s*:\s*\"[^\"]+\"\s*,\s*\"type\"\s*:\s*\"function\"\s*,\s*\"function\"\s*:\s*\{.*?\}\s*\})z
gh-copilot)zhas been deprecatedz no commands will be executed stderr_textstrreturnboolc | t fdt D sdS t fdt D S )zHTrue iff stderr looks like the deprecated gh-copilot extension's banner.c 3 K | ]}|v V d S N ).0reqlowers >/home/rurouni/.hermes/hermes-agent/agent/copilot_acp_client.py z5_is_gh_copilot_deprecation_message..9 s' ==se|====== Fc 3 K | ]}|v V d S r r )r markerr s r r z5_is_gh_copilot_deprecation_message..; s' BB6vBBBBBBr )r any_DEPRECATION_REQUIRED_DEPRECATION_MARKERS)r r s @r "_is_gh_copilot_deprecation_messager" 5 se
E ===='<=== = = u BBBB-ABBB B BBr c t j dd p(t j dd pdS )NHERMES_COPILOT_ACP_COMMAND COPILOT_CLI_PATHcopilot)osgetenvstripr r r _resolve_commandr+ > sL
.3399;;
9' , , 2 2 4 4 r list[str]c t j dd } | sddgS t j | S )NHERMES_COPILOT_ACP_ARGSr% z--acpz--stdio)r( r) r* shlexsplit)raws r
_resolve_argsr2 F sC
)-r
2
2
8
8
:
:C $## ;s r c r t j dd } | r| S t j d }|r|dk r|S ddl}| t j j }|r|S n# t $ r Y nw xY wdS )z-Return a stable HOME for child ACP processes.HOMEr% ~r Nz/tmp) r( environgetr* path
expanduserpwdgetpwuidgetuidpw_dir Exception)homeexpandedr: resolveds r _resolve_home_dirrB M s
:>>&" % % + + - -D w!!#&&H HOO
<< ,,399;; O
6s !AB' '
B43B4dict[str, str]c n t d } t }|| d< ddlm} || | S )NT)inherit_credentialsr4 r )apply_subprocess_home_env)r rB hermes_constantsrF )envr? rF s r _build_subprocess_envrI f sP D
9
9
9C DCK:::::: c""" Jr
message_idr codeintmessagedict[str, Any]c d| ||ddS )N2.0)rK rM )jsonrpciderrorr )rJ rK rM s r _jsonrpc_errorrT r s'
r c d| dddiidS )NrP outcome cancelledrQ rR resultr )rJ s r _permission_deniedrZ } s) ;
r messageslist[dict[str, Any]]model
str | Nonetoolslist[dict[str, Any]] | None tool_choicec h g d}|r| d| t |t r
|r
g }|D ]}t |t s| d pi }t |t sE| d }t |t
r| s| | | dd | di d |r,| d t j |d
z |,| d t j |d
g } | D ]}
t |
t st |
d
pd } | dk rd} n| dvrd} |
d } t | }
|
sdddddd | | }| | d|
| r+| dd | z | d d d |D S ) N)z>You are being used as the active ACP agent backend for Hermes.z'Use ACP capabilities to complete tasks.zIMPORTANT: If you take an action with a tool, you MUST output tool calls using {...} blocks with JSON exactly in OpenAI function-call shape.z&If no tool is needed, answer normally.z Hermes requested model hint: functionname descriptionr%
parameters)rd re rf zAvailable tools (OpenAI function schema). When using a tool, emit ONLY {...} with one JSON object containing id/type/function{name,arguments}. arguments must be a JSON string.
F ensure_asciizTool choice hint: roleunknowntool> usersystem assistantcontextcontentSystemUser AssistantToolContext)rm rl rn rk ro z:
zConversation transcript:
z
z7Continue the conversation from the latest user request.c 3 j K | ].}|| | V /d S r r* )r sections r r z-_format_messages_as_prompt.. s< ^^7'^gmmoo^w}}^^^^^^r )
append
isinstancelistdictr7 r r* jsondumpsr _render_message_contenttitlejoin)r[ r] r_ ra sections
tool_specstfnrd
transcriptrM ri rp renderedlabels r _format_messages_as_promptr s H
A???@@@% 5 +-
A a&&
z""(bB b$''
66&>>D dC((
JJLL#%66-#<#<"$&& r":":
OOb *Ze<<<=
ZTZ RW-X-X-XZZ[[[ J 3 3'4(( 7;;v&&3)44::<<BBDD 6>>DD
8
8
8 D++i((*733 $
#dDJJLL
!
!
U11x112222 R6Z9P9PPQQQ OOMNNN ;;^^h^^^ ^ ^^r rp c | dS t | t r| S t | t rd| v r6t | d pd S d| v r^t | d t r6t | d pd S t j | d S t | t rg }| D ]}t |t r| | -t |t re| d }t |t r;| r'| | d | S t | S )Nr% textrp Trg
)
rz r r* r| r7 r} r~ r{ ry r )rp partsitemr s r r r s r'3 }} '4 6 W w{{6**0b117799 9 Jw{{9/E/Es$K$K w{{9--344::<< <z'5555'4 ( / /D$$$
/ T""""D$''
/xx'' dC(( /TZZ\\ /LL ...yy %%''' w<< r call_idrd argumentsr c
H t | | ddt || S )zDBuild an OpenAI-compatible tool-call object for downstream handling.Nrc rd r )rR r response_item_idtyperc r r rd r s r _build_openai_tool_callr s7 )
ty999 r
completionr list[SimpleNamespace]c N | j d }|j }d}|j rg }t |j D ]\ }}| t |t
|dd t
|dd t t
|j dd t
|j dd t d
|j pd||j |j
}t t d||j g| j d
}t g | j | j
}||gS )z@Convert a one-shot ACP response into OpenAI-style stream chunks.r NrR r rc rd r r )indexrR r rc rn )ri rp
tool_callsreasoning_content reasoning)r delta
finish_reason)choicesr] usage)r rM r enumeratery r getattrrc rp r r r r] r ) r choicerM tool_call_deltasr tool_callr
data_chunk usage_chunks r _completion_to_stream_chunksr sz
"FnG
)'*< = = E9 # # y$55 FJ?? , $Y%7 F F"))* rz r| r7 r r* r~ lenry r )r objr fn_namefn_argsr extracteds r _try_add_tool_callz9_extract_tool_calls_from_text.._try_add_tool_call1 su *X&&CC FF #t$$ F
WWZ
"d## F&&..'3'' w}} F&&d++'3'' >ju===G''$--'3'' 5w}} 54#i.."244G # ]]__!
s
&&r r r c 3 j K | ].}|| | V /d S r rw )r ps r r z0_extract_tool_calls_from_text..m s< DDaAD!''))D DDDDDDr )r r r r )rz r r* _TOOL_CALL_BLOCK_REfinditergroupry startend_TOOL_CALL_JSON_REsortmaxr r ) r consumed_spansr mr1 mergedr r r cursorcleanedr s @r _extract_tool_calls_from_textr * s dC
2v
57I,.N
8 !
)
)$
/
/ 4 4ggajj3 qwwyy!%%'' 23333 8#,,T22 8 8A''!**C s # # # ! !17799aeegg"6 7 7 7 7 '$**,,&&$&F$ B B
s BA .. MM5#, ' ' ' ' *Q-VBZ]C)@)@AF2JJE
F " "
s E>> LLfUl+ , , ,VS!!
D
T&'']###iiDD5DDDDDJJLLG g r path_textcwdr c T t | }| st d | }t | } | | n)# t
$ r }t d| d| d |d }~ww xY w|S )Nz'ACP file-system paths must be absolute.zPath 'z ' is outside the session cwd 'z'.)r is_absolutePermissionErrorresolve relative_to
ValueError)r r candidaterA rootexcs r _ensure_path_within_cwdr r s YI " " I GHHH ""H 99 Db T"""" b b b Wx W Wt W W WXX^aab Os )A? ?
B% B B%c e Zd Zd dZd
dZdS ) _ACPChatCompletionsclient'CopilotACPClient'c || _ d S r )_clientselfr s r __init__z _ACPChatCompletions.__init__ s
r kwargsr r c & | j j di |S )Nr )r _create_chat_completion)r r s r createz_ACPChatCompletions.create s 3t|3==f===r Nr r )r r r r )__name__
__module__ __qualname__r r r r r r r s< > > > > > >r r c e Zd ZddZdS )_ACPChatNamespacer r c . t | | _ d S r )r completionsr s r r z_ACPChatNamespace.__init__ s .v66r Nr )r r r r r r r r r s( 7 7 7 7 7 7r r c ^ e Zd ZdZdddddddddd/dZd0dZdddddddd1d Zd2d&Zd3d.ZdS )4CopilotACPClientz8Minimal OpenAI-client-compatible facade for Copilot ACP.N)api_keybase_urldefault_headers acp_commandacp_argsacp_cwdcommandargsr r^ r r dict[str, str] | Noner r list[str] | Noner r r _r c |pd| _ |pt | _ t |pi | _ |p|p
t | _ t |p|p
t | _ t t |pt j
| _ t! | | _ d| _ d | _ t) j | _ d S )N copilot-acpF)r ACP_MARKER_BASE_URLr r| _default_headersr+ _acp_commandr{ r2 _acp_argsr r r( getcwdr _acp_cwdr chat is_closed_active_process threadingLock_active_process_lock)
r r r r r r r r r r s
r r zCopilotACPClient.__init__ s /- 7$7
$_%: ; ; ' H7 H6F6H6H h A$ A-//BBD!7BIKK 8 8 @ @ B BCC
%d++ =A $-N$4$4!!!r r r c < | j 5 | j }d | _ d d d n # 1 swxY w Y d| _ |d S | | d d S # t
$ r+ | Y d S # t
$ r Y Y d S w xY ww xY w)NT timeout)r r r terminatewaitr> kill)r procs r closezCopilotACPClient.close s
& ( ('D#'D ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( < F NN IIaI
s5 #''*A& &
B1B
BBBBF)r] r[ r r_ ra streamr] r[ r` r float | Noner_ ra r r c F t |pg ||| }t } n^t t t f rt } n2fddD }
d |
D } | rt | nt } | || \ } }
t | \ }}t dddt d }t |||
pd |
pd d }|rd
nd }t || }t |g||pd
}|rt | S |S )N)r] r_ ra c 2 g | ]}t |d S r )r )r attrr s r
z. s5 t,, r )readwriteconnectpoolr c d g | ]-}t |t t f t | .S r )rz rL float)r vs r r z. s1 UUUQAU|9T9TUaUUUr )timeout_secondsr )
cached_tokens)
prompt_tokenscompletion_tokens total_tokensprompt_tokens_details)rp r r r reasoning_detailsr stop)rM r r )r r r] )
r _DEFAULT_TIMEOUT_SECONDSrz rL r r _run_promptr r r )r r] r[ r r_ ra r r prompt_text_effective_timeout _candidates_numeric
response_textreasoning_textr cleaned_textr assistant_messager r r s ` r r z(CopilotACPClient._create_chat_completion s 1 N#
?!9
#u
.
.
Y!&w K K VU+UUUH2:!XX @X (,(8(8 . )9 )
)
%
~
$A #O#O
L "1"B"B"B
, !$, , 4 "
)3>
):-XXX$H(=
</
;; ;r r% r r r tuple[str, str]c
t j j g j z t j t j t j dd j t
n+# t $ r }t d j d |d }~ww xY wj j
# t d d _ j
5 _ d d d n # 1 swxY w Y t j
t# d d+
fd }d+fd
}t% j |d }t% j |d }| | dd d dd,
fd} |dddddd id d d d d! |d" j g d# pi } t+ | d$ pd% }
|
st d& g } g } |d'|
d(|d)gd*| | d% | d% | f S # w xY w)-NTr )stdinstdoutstderrr bufsizer rH z%Could not start Copilot ACP command 'zQ'. Install GitHub Copilot CLI or set HERMES_COPILOT_ACP_COMMAND/COPILOT_CLI_PATH.z6Copilot ACP process did not expose stdin/stdout pipes.F( )maxlenr r c j d S j D ]d} t j | +# t $ r- d| d i Y aw xY wd S )Nr1 r )r0 putr} r r> rstrip)lineinboxr s r _stdout_readerz4CopilotACPClient._run_prompt.._stdout_reader s {"
:
::IIdj . .//// : : :IIudkk$&7&7 899999:
:
:s '=4A43A4c ~ j d S j D ]*} | d +d S )Nr )r1 ry r7 )r8 r stderr_tails r _stderr_readerz4CopilotACPClient._run_prompt.._stderr_reader sN {"
6
6""4;;t#4#45555
6
6r )targetdaemonr )
text_partsreasoning_partsmethodr paramsrN r@ r rA r c dz
}d|| |d} j t j | dz j t j z }t j |k r։ n
d }n# t j
$ r Y Uw xY w
|
j || ry| d |k rd |v rA| d pi }t d
| d | d p| | d
S d } 5| r3t! | rt d| t d| t# d| d )Nr rP )rQ rR rB rC r g?r )processr r@ rA rR rS z Copilot ACP z failed: rM rY a0 Hermes ACP mode requires the NEW GitHub Copilot CLI (github.com/github/copilot-cli), but the binary it just spawned is the deprecated `gh copilot` extension.
Install the new CLI:
npm install -g @github/copilot
# then verify with: copilot --help
If `copilot` already resolves to the new CLI but you still see this,
point Hermes at it explicitly:
export HERMES_COPILOT_ACP_COMMAND=/path/to/new/copilot
Alternative: use the `copilot` provider (no ACP, hits the Copilot API
directly with a Copilot subscription token) via `hermes setup`.
Original error:
z"Copilot ACP process exited early: z.Timed out waiting for Copilot ACP response to .)r/ r r} r~ flushtime monotonicpollr7 queueEmpty_handle_server_messager RuntimeErrorr r* r" TimeoutError)rB rC r@ rA
request_idpayloaddeadlinemsgerrr r9 next_idr r r< r s r _requestz.CopilotACPClient._run_prompt.._request+ s& qLG J G
J TZ 0 04 7 8 8 8 J ~''/9H.""X--99;;* ))C)00CC { H ..
)$3 / 774==J.. c>> '''**0bC&SvSS 8J8J8QcSS wwx((( ))K006688Kyy{{&;&5kBB & : -8 : :
##U #U#UVVV YPV Y Y YZZ Zs B2 2CC
initializefs) readTextFile
writeTextFilez hermes-agentz Hermes Agentz0.0.0)rd r version)protocolVersionclientCapabilities
clientInfoz session/new)r
mcpServers sessionIdr% z'Copilot ACP did not return a sessionId.zsession/promptr )r r )r` promptr r )
rB r rC rN r@ r rA r r r )
subprocessPopenr r PIPEr rI FileNotFoundErrorrN r/ r0 r r r r rK Queuer r Threadr r r7 r* r r
)r r% r r r: r=
out_thread
err_threadrV session
session_idr@ rA r9 rU r r< s ` ` @@@@r r$ z CopilotACPClient._run_prompt s #"#dn4 o!!M)++ DD ! a8I a a a
: !4 IIKKK WXX X
& ( (#'D ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( .3[]]"'r"2"2"2 : : : : : : : 6 6 6 6 6 6 6 %^DIII
%^DIII
\` GK : [ : [ : [ : [ : [ : [ : [ : [ : [ : [ : [ : [ : [x/ H '( ,0-1 + !/!/#*# #
" h ="$
W[[ 5 5 ;<<BBDDJ
N"#LMMM$&J)+O H !+ %+$/ & /
77:&&(@(@@ JJLLLLDJJLLLLs7 AA" "
B
,BB
C C$'C$B9I I&rS rN rE subprocess.Popen[str]r r@ rA c | d }t |t sdS |dk r| d pi }| d pi }t | d pd } | d pi }
d} t |
t r$t |
d pd } | d
k r| r|| | n | d k r| r|| | d S |j d S | d
} | d pi }|dk rt | }
n|dk rz t t | d pd | }t t | }|rt | | }
n# t $ r d}
Y nw xY w| d }| d }t |t r`|dk rZ|
d }|dz
}t |t r |dk r||z nd }d ||| }
|
rt! |
d }
d| d|
id}
nB# t" $ r)}t% | dt | }
Y d }~nd }~ww xY w|dk r t t | d pd | }t' t | rt d| d |j d d | t | d pd d| d d}
nJ# t" $ r(}t% | dt | }
Y d }~n d }~ww xY wt% | d d | d }
|j t1 j |
d!z |j d S )"NrB Fzsession/updaterC update
sessionUpdater% rp r agent_message_chunkagent_thought_chunkTrR zsession/request_permissionzfs/read_text_filer8 r8 limitr )keependsr )forcerP rX izfs/write_text_filezWrite denied: 'z(' is a protected system/credential file.)parentsexist_okizACP client method 'z!' is not supported by Hermes yet.r )r7 rz r r* r| ry r/ rZ r r r read_textrf rL
splitlinesr r
r> rT r parentmkdir
write_textr r} r~ rG )r rS rE r r@ rA rB rC ro kindrp
chunk_textrJ responser8 block_errorr8 rs linesr r r s r rM z'CopilotACPClient._handle_server_message s ""&#&& 5 % % %WWX&&,"FZZ))/RFvzz/228b99??AAD jj++1rGJ'4((
< V!4!4!: ; ;
,,,,
@V!!*----...:./B] &&z2224 = 4WWT]]
""(b 1 1 1)*55HH
*
*
*
H.s6::f3E3E3K/L/LcRR 23t99 = = 7)+666! "nn . .GG( ! ! ! GGG! zz&))
7++ dC(( 8TAXX # . . . = =E 1HE+5eS+A+AYeaii%%--UYC ggeE#I&6 7 7G I 3G4 H H HG $$!7
H
H
H)*fc#hhGG
H
+
+
+
H.s6::f3E3E3K/L/LcRR"3t99-- )X$XXX !!$!>>>FJJy$9$9$?R @ @AAA $$ "
H
H
H)*fc#hhGG
H &OfOOO H
DJx 0 04 7888
tsW >A K G3 2K 3 H?K HB=K
K4 K//K4>B:N9 9
O+ O&&O+)r r^ r r^ r r r r^ r r r r^ r r^ r r r r rb )r] r^ r[ r` r r r_ r` ra r r r r r r r )r% r r r r r- ) rS rN rE rm r r r@ r rA r r r ) r r r __doc__r r
r r$ rM r r r r r s BB
# #15"&%) " "!%5 5 5 5 5 50 ( !04 $-1 > > > > > >@^ ^ ^ ^@X X X X X Xr r )r r r r )r r )r r, )r rC )rJ r rK rL rM r r rN )rJ r r rN )NNN)
r[ r\ r] r^ r_ r` ra r r r )rp r r r )r r rd r r r r r )r r r r )r r r r )r r r r r r )5r
__future__r r} r( rK rer/ rc r rH collectionsr pathlibr typesr typingr 3openai.types.chat.chat_completion_message_tool_callr r
agent.file_safetyr r agent.redactr
tools.environments.localr r r# compileDOTALLr r r r! r" r+ r2 rB rI rT rZ r r r r r r r r r r r r r s2 # " " " " " ! ! ! ! ! !
D C C C C C C C . . . . . . : : : : : :% bj!JBIVV RZ !H JL JS T T ( C C C C 2 )- H_ H_ H_ H_ H_V 0
+% +% +% +%\D D D D P
> > > > > > > >7 7 7 7 7 7 7 7
d d d d d d d d d dr