Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
package runtime
func dockerConversationProcessArgv(file string, argv []string) []string {
return withToolchainPath(append([]string{"python3", "-c", dockerConversationProcessSupervisor, file}, argv...))
}
func dockerConversationStopArgv(file string) []string {
return withToolchainPath([]string{"python3", "-c", dockerConversationProcessStop, file})
}
// A CLI may create new sessions for its native shell tools. Killing only its
// process group leaves those tools running. A Linux subreaper owns even orphaned
// and double-forked descendants without affecting other commands in the same
// workspace container. It preserves stdin and waits for cleanup before exit.
const dockerConversationProcessSupervisor = `import ctypes,json,os,signal,subprocess,sys,time
path=sys.argv[1]
stopped=path+'.stop'
cancelled=False
def cancel(signum,frame):
global cancelled
cancelled=True
for sig in (signal.SIGTERM,signal.SIGINT,signal.SIGHUP):
signal.signal(sig,cancel)
def stat(pid):
try:
with open('/proc/'+str(pid)+'/stat') as f:
fields=f.read().rsplit(')',1)[1].split()
return int(fields[1]),fields[19]
except (OSError,ValueError,IndexError):
return None
me=os.getpid()
identity=stat(me)
if identity is None or ctypes.CDLL(None,use_errno=True).prctl(36,1,0,0,0)!=0:
sys.exit('native CLI requires Linux child subreaper support')
def state(status):
temp=path+'.tmp'
fd=os.open(temp,os.O_WRONLY|os.O_CREAT|os.O_TRUNC|os.O_NOFOLLOW,0o600)
with os.fdopen(fd,'w') as f:
json.dump({'pid':me,'start':identity[1],'status':status},f)
os.replace(temp,path)
def descendants():
rows={}
for name in os.listdir('/proc'):
if name.isdigit():
entry=stat(int(name))
if entry is not None:
rows[int(name)]=entry
owned={me}
while True:
more={pid for pid,(parent,start) in rows.items() if parent in owned}
if more.issubset(owned):
break
owned.update(more)
return {pid:rows[pid][1] for pid in owned if pid!=me}
def send(pid,start,sig):
entry=stat(pid)
if entry is not None and entry[1]==start:
try:
os.kill(pid,sig)
except ProcessLookupError:
pass
def cleanup(child):
# Freeze parents before killing them, then rescan for children created
# during that snapshot. Subreaper adoption retains every owned process.
frozen={}
while True:
current=descendants()
for pid,start in current.items():
send(pid,start,signal.SIGSTOP)
if current.items()<=frozen.items():
break
frozen.update(current)
for pid,start in frozen.items():
send(pid,start,signal.SIGKILL)
code=child.wait(timeout=5) if child is not None else 0
deadline=time.monotonic()+5
while True:
try:
pid,_=os.waitpid(-1,os.WNOHANG)
except ChildProcessError:
break
if pid==0:
if time.monotonic()>deadline:
raise RuntimeError('native CLI descendants did not exit')
time.sleep(0.01)
return code
child=None
code=1
try:
state('running')
# The stop marker also fences cancellation before docker exec reaches
# this wrapper. A late launch cannot begin a new CLI after stop returned.
if not cancelled and not os.path.exists(stopped):
child=subprocess.Popen(sys.argv[2:],start_new_session=True)
while child.poll() is None and not cancelled and not os.path.exists(stopped):
time.sleep(0.05)
finally:
code=cleanup(child)
state('done')
sys.exit(143 if cancelled or os.path.exists(stopped) else (code if code>=0 else 128-code))
`
// A PID's Linux start time prevents a stale control file from signalling a
// reused PID. A stop marker is retained if launch has not reached the container.
const dockerConversationProcessStop = `import json,os,signal,sys,time
path=sys.argv[1]
stopped=path+'.stop'
try:
fd=os.open(stopped,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,0o600)
os.close(fd)
except FileExistsError:
pass
deadline=time.monotonic()+7
while True:
try:
with open(path) as f:
state=json.load(f)
except FileNotFoundError:
break
if state['status']=='done':
os.unlink(path)
os.unlink(stopped)
break
try:
with open('/proc/'+str(state['pid'])+'/stat') as f:
start=f.read().rsplit(')',1)[1].split()[19]
except FileNotFoundError:
sys.exit('native CLI supervisor exited without cleanup')
if start!=state['start']:
sys.exit('native CLI supervisor identity changed')
try:
os.kill(state['pid'],signal.SIGTERM)
except ProcessLookupError:
pass
if time.monotonic()>deadline:
sys.exit('native CLI supervisor did not stop')
time.sleep(0.05)
`