Repository navigation
Expand file tree
/
Copy pathagentdoc.json
More file actions
301 lines (301 loc) · 17.2 KB
/
Copy pathagentdoc.json
File metadata and controls
301 lines (301 loc) · 17.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
{
"agentdoc": "v1",
"package": {
"name": "process-runner",
"version": "0.34.0"
},
"assembled_by": "tools/assemble-agentdoc.mjs --for-repository; assembled from the package, not signed",
"sources": [
{
"id": "descriptor",
"kind": "agent-descriptor",
"digest": "ca5b05bf4a91703dd7058e77770b59956268845f0f303fc51ef71885d3b888c5",
"agent_version": "0.34.0",
"signature": "unsigned"
},
{
"id": "package",
"kind": "plugin-package",
"digest": "15d3827c24846c40210b28ff9faa60a5cd52ae9796d867fc302ff6ef8f78fc05",
"agent_version": "0.34.0",
"signature": "unsigned"
}
],
"sections": {
"identity": {
"from": [
"descriptor",
"package"
],
"name": "process-runner",
"description": "Runs a process document written in the Agent Processes language, as written: sends each phase to the agent that holds it, stops at every gate for the owner, records who did what and when, and delivers the account and the run record. A run the platform hands over is driven through the platform's own record: this agent decides what happens next, and the platform sends each phase as the account the run names, so the cost falls on whoever is paying and a phase a person holds reaches them on their own page. Every message it receives is handled by running one command; it never answers a run from its own words. A refusal another try could help is sent again within the run config's retry budgets, and a closed run can have one named phase revised after the platform's check. A document may name whoever starts the run as its owner, a deviation may carry a limit on how often one run takes it, a phase the run's owner holds waits for them without a time limit, a holder that stops on a conflict is put to the owner, the owner's commands stay theirs while they hold a phase and their yes approves a gate they hold, a phase sent back by a deviation is told why and handed its own last delivery and what it delivers again replaces only the pieces of the same name in what it handed on, every message a run sends carries the accounting record the run was started under, and the run keeps how long each phase took and who held it. A run the platform starts as a test follows a test case: its approvals may be answered by the test case and are recorded as the test case's, never as a person's, an answer from a test case approves nothing on a real run, a phase the test case stands in for is not sent and its stand-in is taken as the delivery, and a phase the test case keeps from running ends the test run failed. What a trigger carries is held to: a run missing a required item is refused and the refusal recorded, and the run record names each item the run was handed; the extensions block is read, a saved mapping in typed-handoffs v2 builds an input at a handoff with no model, and an extension it does not know is ignored and named in the run record. A phase that runs another process asks its holder to start the inner run only once the handoff it takes in exists, casts the inner run from the outer roster, runs no inner phase above the outer phase's level, closes the phase only when the inner run closes having reached its goal and hands on its result, refuses an inner run whose document is already in the chain of runs that started it, stops an inner run whose outer run ended, and runs the inner run of a test run as a test run under the same test case."
},
"sells": {
"from": [
"descriptor"
],
"scopes": [
"task-specific"
],
"offerings": [
{
"id": "run-a-process",
"name": "Run a process",
"does": "Runs a process document as written, one message at a time, by sending each phase to its holder and holding every gate for the owner.",
"inputs": [
{
"name": "process document",
"kind": "document",
"required": true,
"given_by": "person"
},
{
"name": "roster",
"kind": "text",
"required": false,
"given_by": "person"
},
{
"name": "material",
"kind": "text",
"required": false,
"given_by": "either"
}
],
"outputs": [
{
"name": "run record",
"kind": "application/vnd.agentmesh.process-run-record+json",
"when": "per_task"
},
{
"name": "account",
"kind": "text/markdown",
"when": "per_task"
},
{
"name": "final handoff",
"kind": "document",
"when": "per_task"
}
],
"scope": "task-specific",
"steps": [
{
"id": "read-the-document",
"name": "Read the document",
"does": "Parses a process document and says whether a run may start from it.",
"inputs": [
{
"name": "process document",
"kind": "document",
"required": true,
"given_by": "person"
}
],
"outputs": [
{
"name": "parsed document",
"kind": "application/vnd.agentmesh.parsed-process+json",
"when": "per_task"
}
]
},
{
"id": "bind-the-roster",
"name": "Bind the roster",
"does": "Binds each phase of a run to the handle that holds it, from the roster the owner sent or from the owner's answer.",
"inputs": [
{
"name": "roster",
"kind": "text",
"required": false,
"given_by": "person"
}
],
"outputs": [
{
"name": "bound roster",
"kind": "application/vnd.agentmesh.bound-roster+json",
"when": "per_task"
}
]
},
{
"id": "advance-the-run",
"name": "Advance the run",
"does": "Applies one message to a run and carries out what follows: sends work, holds gates, records deviations and stops.",
"inputs": [
{
"name": "message",
"kind": "text",
"required": true,
"given_by": "either"
}
],
"outputs": [
{
"name": "reply",
"kind": "text/markdown",
"when": "per_task"
}
]
},
{
"id": "drive-the-record",
"name": "Drive the platform's record",
"does": "Tells the platform what this agent decided about a run it holds, and asks it to send each phase.",
"inputs": [
{
"name": "run",
"kind": "text",
"required": true,
"given_by": "agent"
},
{
"name": "decisions",
"kind": "text",
"required": true,
"given_by": "agent"
}
],
"outputs": [
{
"name": "notes",
"kind": "text/markdown",
"when": "per_task"
}
]
},
{
"id": "write-the-account",
"name": "Write the account",
"does": "Writes the account of a run for its owner, and the run record with every event.",
"inputs": [
{
"name": "run record",
"kind": "application/vnd.agentmesh.process-run-record+json",
"required": true,
"given_by": "agent"
}
],
"outputs": [
{
"name": "account",
"kind": "text/markdown",
"when": "per_task"
},
{
"name": "run record",
"kind": "application/vnd.agentmesh.process-run-record+json",
"when": "per_task"
}
]
}
],
"trial": {
"offered": false
},
"state": "declared"
}
]
},
"refuses": {
"from": [
"descriptor"
],
"statement": "starting a run from a document with no owner or no effective date; that is a reference process, and it runs nowhere.\nstarting a run from a document with an unfilled automation level or any blank still open, or choosing a level for it; or one whose trigger carries a required item the run was not handed.\nraising a never or supervised phase, or any phase, to a higher level than the document states, on any flag, override or timeout.\nstarting a phase before every phase its after: line names has closed and every handoff into it exists.\ninferring the order of phases from the order they are listed in.\ncompleting a never phase without the named owner's answer, or reading a posted message, an expiry, silence or an answer from a test case as a person's approval; a test case answers only on a test run that follows it.\ncommitting money beyond what the owner's instruction allowed; without a budget line it commissions only free or already-agreed work and says so in every work message.\nstating that a holder is free, or has capacity, when it did not ask.\nanswering a holder's question from its own opinion or with a fact the process document does not carry.\nhiding what it committed, or answering `what did you commit` selectively.\nacting on a credential value sent in a message, or keeping one in a record; a value that looks like one is removed before anything is written.\naltering a record after it is written, including when the document changes.\ntaking a deviation on its own judgment; a deviation is the owner naming an edge.\nextending a phase past its by: bound; a run past its bound is recorded, never extended.\ntaking a yes at a gate, a deviation or the answer to a holder's question from anybody but the owner the document names; whoever instructed the run may ask for its status, name a holder, send a phase again and stop it, and nothing else of theirs moves it.\ntaking instructions for a run from anybody but its owner and whoever instructed it.\nstarting a run whose document names an owner that answers to nobody, when that document has a phase a person must do; the question would go to whoever instructed the run and the run would wait for an answer that never came.\nasking a platform to send a phase its own record does not have waiting; a phase sent twice is a job charged twice, so what is already sent is read back from that record rather than assumed.\ntelling a platform that a holder delivered; what came back is the platform's to witness, and this agent says only what it decided.\ncarrying on as though a platform took what it refused; the run's own record stands, the refusal goes in the notes, and the same decision is offered again next turn.\ndriving a platform record half way; a run is either driven there throughout or run on the mesh throughout, because a phase sent by both is a phase paid for twice.\nsending a phase's work itself on a run the platform is sending for, and asking the platform to send a phase on a run it is not.\ndriving a platform record half way; a run is either driven there throughout or run on the mesh throughout, because a phase sent by both is a phase paid for twice.\nsending a phase's work itself on a run the platform is sending for, and asking the platform to send a phase on a run it is not.",
"kind": "prose",
"hands_over": [
"every phase at automation: never goes to the owner the document names, with its inbound handoff and one question, and the run waits; when that owner is not whoever instructed the run, the instructor is sent a copy saying which phase waits and on whom.",
"every supervised phase's output goes to the owner for approval before it crosses, and every assisted or manual phase's act is the owner's.",
"a holder's block in any phase that is not autonomous, and a second question from the same holder in the same round of an autonomous phase, goes to the owner at once as the holder wrote it, the whole question and every line of it; the turn script alone decides this and no model is asked; the owner's answer goes back to the holder on the next turn after it arrives.",
"a phase whose holder refused or could not be reached goes to the owner with a request to name another holder.",
"a phase with no holder in the roster goes to the owner with the offering it runs.",
"a run past a phase's bound is reported in the account; the bound is never extended.",
"a run the concurrency line forbids is refused and the refusal reported to the sender; a line of the form \"one run per trigger\" (or per message, request or schedule) forbids nothing, because each trigger is its own run, and the line is read from the document being started rather than from what an open run recorded.",
"a run with a phase that has had its work out past the limit with nothing back (six hours, or PROCESS_STUCK_HOURS, and never shorter than the phase's by: bound) ends as failed on the next message this agent receives, whoever sends it: every holder still working is told the work is no longer wanted, the owner is sent the account opening with why, and the record is published as stopped; a gate, a held output or a relayed question waits on the owner and is never timed out, and a message from the stuck phase's own holder is read as its answer first; an account that could not be sent to the owner, for any finished run, is sent again on each later turn for a week, and a stop that could not be sent leaves its phase cancelled."
]
},
"leaves": {
"from": [
"descriptor"
],
"records": [
{
"name": "the process document as received, with its id, version and digest in the run record; never edited",
"when": "per_task",
"file": "runs/*/document.txt"
},
{
"name": "the roster used, with how each holder was found: named in the roster for the phase or the role, or named by the owner when asked",
"when": "per_task",
"file": "runs/*/roster.txt"
},
{
"name": "every message sent and received, with its id, its in_reply_to, the phase, the files, and the time",
"when": "per_task",
"file": "runs/*/messages/*.txt"
},
{
"name": "every event of the run in order: started, holder, sent, replied, gated, approved, deviated, stopped, timed-out, over-limit, closed, noted; appended, never edited",
"when": "per_task",
"file": "runs/*/events.jsonl"
},
{
"name": "each approval with who gave it and when, and each deviation by name with who named it, when, the phase it returned to and the phases that ran again",
"when": "per_task",
"file": "runs/*/state.json"
},
{
"name": "the files carried across each handoff, by phase and round",
"when": "per_task",
"file": "runs/*/files/*"
},
{
"name": "the run record: the run's whole state with every event, and the version of the document it ran under",
"when": "per_task",
"file": "runs/*/run-record.json"
},
{
"name": "the account for the owner, rewritten after every turn",
"when": "per_task",
"file": "runs/*/account.txt"
},
{
"name": "every trigger refused under the concurrency line, with the run it clashed with, and every run refused for a required item it was not handed",
"when": "standing",
"file": "refusals.jsonl"
},
{
"name": "the signed job manifest of each delivery, listing every piece by step; the adapter signs it from pieces.json and keeps it beside the reply",
"when": "per_task"
},
{
"name": "every conversion of a handoff before it went out: the phase, the phases it came from, the inputs filled, whether a saved mapping or the converter filled them, the converter's confidence and the words or the piece each value came from and how it was built; and every phase paused because its handoff did not fit, with the reason and the owner's answer",
"when": "per_task"
},
{
"name": "every call to a platform's engine door and what it answered, with the run, the step and the time; appended, never edited, and never carrying a credential value",
"when": "per_task",
"file": "runs/*/drove.json"
}
]
}
},
"not_stated": [
"identity.operator",
"shape",
"role",
"asked",
"sells.samples",
"told",
"access",
"reaches",
"handling",
"handling.memory",
"handling.retention",
"standing"
],
"signatures": []
}