@osolmaz/pi-workflows 0.8.1 → 0.8.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/MONITOR.md +4 -4
- package/package.json +1 -1
- package/skills/monitor/SKILL.md +17 -4
package/docs/MONITOR.md
CHANGED
|
@@ -19,13 +19,13 @@ The monitor checks a target, sends one status notification after every accepted
|
|
|
19
19
|
|
|
20
20
|
| Field | Required | Type | Default | Meaning |
|
|
21
21
|
| --------------------- | -------- | ------- | ------------------ | -------------------------------- |
|
|
22
|
-
| `task` | Yes | string | None | Self-contained
|
|
22
|
+
| `task` | Yes | string | None | Self-contained monitor task. |
|
|
23
23
|
| `everyMinutes` | No | integer | `30` | Minutes between accepted checks. |
|
|
24
24
|
| `stopWhen` | No | string | Explicit user stop | Condition that ends monitoring. |
|
|
25
25
|
| `maxChecks` | No | integer | `1000` | Run safety limit. |
|
|
26
26
|
| `checkTimeoutMinutes` | No | integer | Derived | Timeout for one agent check. |
|
|
27
27
|
|
|
28
|
-
`task` is 1 to 8,000 characters after trimming. It should name the target, stable identifier, source of truth, durable outputs, and
|
|
28
|
+
`task` is 1 to 8,000 characters after trimming. It should name the target, stable identifier, source of truth, durable outputs, authorized routine work, and safety boundary. It must state any authorized mutations. Monitoring is read-only when the task does not authorize a mutation.
|
|
29
29
|
|
|
30
30
|
`everyMinutes` is from 1 through 1,440. The interval begins after a check report is durably queued. It does not delay the first check.
|
|
31
31
|
|
|
@@ -260,11 +260,11 @@ The monitor skill must disclose a surfaced host limit and must never invent a sm
|
|
|
260
260
|
|
|
261
261
|
## Safety boundaries
|
|
262
262
|
|
|
263
|
-
|
|
263
|
+
An observation-only request authorizes only observation and scheduled checks. When the user asks the monitor to keep an objective running or finish it, the monitor skill may record routine, bounded work in `task`, including retries, restarts, pinned task code, tests, configuration repairs, and temporary cleanup. The task must preserve the exact objective and state every mutation boundary.
|
|
264
264
|
|
|
265
265
|
A progress object is data. It cannot contain a command or grant execution authority. Fixed probes belong in workflow-authored `action` or `shell` nodes.
|
|
266
266
|
|
|
267
|
-
Paid compute, inference runtime, and other domain policies continue to apply to every check.
|
|
267
|
+
A monitoring request does not create spending approval or a default spending ceiling. Existing approvals can cover paid actions, and the monitor should continue without another prompt while each action stays within them. Paid compute, inference runtime, and other domain policies continue to apply to every check.
|
|
268
268
|
|
|
269
269
|
## Validation and acceptance
|
|
270
270
|
|
package/package.json
CHANGED
package/skills/monitor/SKILL.md
CHANGED
|
@@ -8,7 +8,7 @@ compatibility: Requires Pi Workflows and the built-in monitor workflow.
|
|
|
8
8
|
|
|
9
9
|
Use the built-in Pi `monitor` workflow as an autopilot for the requested objective. Monitoring is not passive status polling. The agent must maintain nominal operation, repair recoverable failures, resume durable work, and continue until the complete objective is verified or a material blocker makes safe continuation impossible.
|
|
10
10
|
|
|
11
|
-
A monitor request authorizes routine
|
|
11
|
+
A monitor request authorizes routine, bounded work needed to preserve and finish the stated objective, subject to the conversation and repository approval boundaries. Apply other skills as safety and operating instructions. Do not turn their normal checks into new approval requests when the monitored objective and an existing approval already cover the action. Monitoring does not authorize changing the objective, method, model, data source, production selection, or other consequential contract.
|
|
12
12
|
|
|
13
13
|
## Prepare and start without delay
|
|
14
14
|
|
|
@@ -26,7 +26,7 @@ Do not finish the initiating turn before the workflow start call. If a safe cont
|
|
|
26
26
|
|
|
27
27
|
Derive the workflow input from the full conversation:
|
|
28
28
|
|
|
29
|
-
- `task`: State the complete objective, the exact current target and stable identifiers, authoritative status sources, durable progress and final-output surfaces,
|
|
29
|
+
- `task`: State the complete objective, the exact current target and stable identifiers, authoritative status sources, durable progress and final-output surfaces, routine actions authorized by the monitor request, other recorded approvals, immutable boundaries, cost and credential rules, and required validation or downstream operations.
|
|
30
30
|
- `everyMinutes`: Use the user's interval when present. Use `30` when the user gives no interval. The built-in workflow accepts intervals from 1 minute through 24 hours.
|
|
31
31
|
- `stopWhen`: Infer verified completion from the full conversation. Describe completion of the complete objective, not only the end of one physical process. Also name material blockers that require human intervention.
|
|
32
32
|
|
|
@@ -34,11 +34,24 @@ When the conversation gives no clear finish criterion, set `stopWhen` to `Stop o
|
|
|
34
34
|
|
|
35
35
|
Do not invent a finite check count. Omit `maxChecks` unless the user explicitly requests one. The workflow host can apply its own safety upper bound. Disclose that bound if it appears.
|
|
36
36
|
|
|
37
|
+
## Keep routine work moving
|
|
38
|
+
|
|
39
|
+
While the workflow is active, do routine, bounded work required by the exact objective without asking for another confirmation. This includes:
|
|
40
|
+
|
|
41
|
+
- downloading, building, and running code pinned by the monitored objective;
|
|
42
|
+
- building and running task containers from a pinned benchmark or repository revision;
|
|
43
|
+
- installing pinned dependencies in the planned isolated environment;
|
|
44
|
+
- running canaries, tests, retries, restarts, and temporary cleanup;
|
|
45
|
+
- repairing configuration or storage-path errors without changing the method; and
|
|
46
|
+
- continuing paid work that already has applicable approval.
|
|
47
|
+
|
|
48
|
+
Pinned third-party code is part of the objective when the task names its exact repository, revision, lock file, image digest, or benchmark release. Resolve mutable references to immutable revisions when the applicable safety rules require it. Do not ask once per image, package, or task. New unpinned code, unrelated code, or broader privileges remain outside the monitor's authority.
|
|
49
|
+
|
|
37
50
|
## Paid infrastructure authority
|
|
38
51
|
|
|
39
|
-
A monitoring request does not grant spending approval or create a default spending ceiling. Before launching, resuming, retrying, or replacing paid work, load and follow the paid-compute, provider, Job-control, and runtime skills that apply.
|
|
52
|
+
A monitoring request does not grant spending approval or create a default spending ceiling. Before launching, resuming, retrying, or replacing paid work, load and follow the paid-compute, provider, Job-control, and runtime skills that apply. Use any applicable approval already recorded in the conversation or repository instructions.
|
|
40
53
|
|
|
41
|
-
|
|
54
|
+
When the paid action remains within the approved method, hardware, concurrency, cumulative cost ceiling, and recovery assumptions, continue without asking again. Stop for a decision before new paid work only when there is no applicable approval, the ceiling would be exceeded, or evidence invalidates an approved assumption.
|
|
42
55
|
|
|
43
56
|
The monitor may use a credential only when the conversation or repository has already authorized that credential's source, destination, and purpose. It may reuse that authorization for retries and replacement attempts under the same objective. It must not discover unrelated credentials, broaden scopes, copy credentials to a new store, or print secret values.
|
|
44
57
|
|