A publication is aimed by the person at the gate: the agent proposes an audience only where the person named one, a call that names none must be asked whatever the rules say, and the approval's answer carries whom it is for and whose it is¶
Decision 965 · accepted · 2026-10-28 · supersedes 850
An agent that published an artifact chose whom it was for. publish_artifact defaulted
visibility to private, the model filled it in from whatever it took the person to
mean, and the approval the clients showed was the bare tool call: a person who allowed
"publish the report" had no say in whether it went to them alone, the team or the whole
organisation, and no way to see which before it did. Who reads an artifact is the one
thing about a publication the person cares about, and it was the one thing the gate did
not ask.
- The model proposes, the person chooses. The tool's description tells the model to
set
visibilityonly to what the person asked for and to leave it out otherwise, so the gate asks.must_ask?/1is true for a call with novisibility: it is asked whatever a per-tool rule, the profile's permission orauto_approvesays, as a write into the config directory is (Decision 823), because nobody but the person may choose the audience, and a rule that says "publishing is fine" said nothing about for whom. A call that names one is asked as anyasktool's and a rule may allow it, since the person named it in the prompt. The tool gainsowner(meorteam): whose a team publication is, the team's unless toldme, which the plane decides and the hosts pass through toartifact.publishandsession.artifact.publish. - The gate shows a publication, not a tool call.
approval_requestedforpublish_artifactcarriespublication:title,kind,files(how many),visibilityandowneras proposed (nullfor none),idandnote. It is the delegation's shape of request (Decision 850): a request withpublicationis one withdelegationin everything but what it shows, and a client that knows neither sees an approval forpublish_artifactwith its arguments. - The answer carries whom it is for.
approval.respondtakesvisibility(one of the four shapes; whether the person is in the team is the plane's to refuse, at publish, so the gate does not pretend to know) andowner, withreasonon a denial as a delegation's. Anallownaming no visibility where the model named none is refused with "say whom it is for: ..." and the request waits on: an artifact is published for somebody.approval_decidednames thevisibilityandownerthe call ran with and which the personedited; an audience chosen where the model proposed none counts as edited, since it is the person's and not the model's. The tool runs with the person's choice laid over the model's arguments, in the one place a task tool's allowed call proceeds (Troupe.Tools.run_task/4), and its answer says "as the person chose", so the model does not take its proposal for what happened.Troupe.Tool.Ctxcarries the answer (answer) for that sentence; the arguments carry the choice. allow_sessionon an unaimed publication is this call'sallow. A standing permission to publish would let the next call run for an audience not yet chosen, which is exactly what the must-ask forbids; so it is recorded and acted on asallow, as a managed session's is. On a publication that named a visibility it is the usual standing allow for the tool.- Every answer is a call now. Decision 850 kept a plain word as the cast it had been
and checked only an answer that carried more. A bare
allowto a publication nobody aimed is the wrong answer, and a cast could only drop it; soApprovals.decide/5is aGenServer.callfor every answer, and a wrong plain word is refused to its sender like a wrong brief. That part of 850 is superseded; the rest stands. - Not chosen. Asking the person with
ask_userbefore the call: the model would still carry the answer intovisibility, and the gate would show a tool call again; the gate is where the person already decides, and the choice belongs on the record of that decision. A default audience in the profile or the configuration (artifacts.visibility: team:core), which would answer the gate for a call that said nothing: a reasonable later addition, and one that should be the person's or the organisation's setting rather than the model's guess, so nothing here forecloses it; until then the person chooses each time, which is the safe default for something other people read.
Governs: apps/troupe_core/lib/troupe/tools/publish_artifact.ex, apps/troupe_core/lib/troupe/session/approvals.ex, apps/troupe_core/lib/troupe/tools.ex, apps/troupe_core/lib/troupe/tool.ex, apps/troupe_gateway/lib/troupe/gateway/dispatch.ex, apps/troupe_gateway/lib/troupe/gateway/artifacts.ex, apps/troupe_worker/lib/troupe/worker/artifacts.ex, apps/troupe_protocol/lib/troupe/protocol/schema.ex