com.blockether.vis.internal.council.host — com.blockether/vis 0.2.3

Python host surface. Identity comes from the environment, never the mutable Python session dict.

context clj

(context env)

get clj

(get env entry-id)

(get env entry-id opts)

Fetch a full entry by entry_id; a truncated ping never changes the stored content.

members clj

(members env)

(members env opts)

List active participants as session_id, title and running/queued/held state. No activation ids.

publish clj

(publish env content)

(publish env content opts)

Publish an entry with required kind: complain for failures or concrete improvements, coordination for work/questions, or informational for results/decisions. Complaints enter the persistent improve register. Include the goal, environment/version, preconditions, minimal reproduction steps and sanitized input/tool arguments, expected versus actual behavior, diagnostics, frequency, impact and workaround. Separate evidence from hypotheses; mark missing facts unknown or not attempted. Identify the affected session and turn/iteration/form; source_ref stamps this publication, not another execution. Use read_session(session_id) to inspect original evidence; never copy secrets or private data into the report or replay unsafe operations. Select individual pings, all, or none; kind never selects recipients. FAILED python_execution is already recorded as autocomplain without pings, with failure/timeout, duration and a source-session lookup; enrich its thread with an informational continuation instead of duplicating it. A no-ping continuation answers the latest addressed unanswered request and notifies its author; reply_to selects an unanswered request explicitly, once per recipient. reply_required=True requires an answer before ending the turn, not after every tool invocation. Read or perform authorized work first; acceptance is not task completion. Council is asynchronous message passing: put the delegated goal, authorized scope, acceptance criteria and progress/result in content, not new fields. Explicit ping IDs can wake idle peers; all selects active peers only. A Council-woken session can wake a prior request/reply partner with an explicit same-thread follow-up, but cannot wake unrelated idle peers. See doc("council") for delivery and work protocols.

read clj

(read env)

(read env opts)

Read the group log ascending by entry_id; does not consume pings. group_id defaults to the session group; optional thread_id is a positive root entry_id. after is an exclusive nonnegative integer entry_id cursor (default 0); limit is an integer 1–50 (default 50). Returns entries, after, has_more; pass returned after for the next page while has_more. Pages may be shorter due to the byte budget.

symbols clj

threads clj

(threads env)

(threads env opts)

List thread roots/kinds ascending by thread_id, without content. group_id defaults to the session group. after is an exclusive nonnegative integer thread_id cursor (default 0); limit is an integer 1–50 (default 50). Returns entries, after, has_more; pass returned after for the next page while has_more. Pages may be shorter due to the byte budget. Does not accept thread_id.