tractor/ai/prompt-io/claude
Gud Boi 63df5534bb Add `tractor.to_actor` one-shot task API subpkg
First cut at the `to_thread`/`to_process`-style "run it over there"
wrapper layer from issue #477: a single-remote-task invocation API
decoupled from the `ActorNursery` spawn machinery, composed purely
from the lower level daemon-actor + portal primitives,

- `to_actor.run(fn, **fn_kwargs)` spawns a subactor via
  `ActorNursery.start_actor()`, schedules `fn` as its lone task
  with `Portal.run()` and ALWAYS reaps it via a `finally`-scoped
  `Portal.cancel_actor()` (whose bounded cancel-req wait is
  internally shielded so the reap also runs under caller-scope
  cancellation).
- remote errors raise directly in the caller's task as boxed
  `RemoteActorError`s, moving error collection/propagation up into
  whatever local `trio` scope encloses the call.
- "placement" opts: `portal=` reuses a running actor (no
  spawn/reap), `an=` spawns from a caller-managed actor-nursery,
  neither opens a private call-scoped `open_nursery()` (implicitly
  booting the runtime, tunable via pass-through `runtime_kwargs`).
- fail-fast validation BEFORE any spawn: non-streaming async fn
  only (same constraint as `Portal.run()`), `portal=`/`an=` mutual
  exclusion and no `runtime_kwargs` alongside a placement opt.

Also,
- x-ref the successor API from `.run_in_actor()`'s deprecation TODO
  + docstring; emitting a formal `DeprecationWarning` waits on
  migrating in-repo usage.
- log prompt-io provenance per NLNet policy incl. the driver prompt
  file.

Prompt-IO: ai/prompt-io/claude/20260702T154255Z_65bf9df5_prompt_io.md

(this patch was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code
2026-07-02 12:10:19 -04:00
..
20260406T172848Z_02b2ef1_prompt_io.md Add per-`ctx_key` isolation tests for `maybe_open_context()` 2026-04-06 14:37:47 -04:00
20260406T193125Z_85f9c5d_prompt_io.md Add xfail test for `_Cache.run_ctx` teardown race 2026-04-06 18:17:04 -04:00
20260406T222648Z_f086222_prompt_io.md Add prompt-io log for `run_ctx` teardown analysis 2026-04-09 14:42:42 -04:00
20260406T222648Z_f086222_prompt_io.raw.md Condense `.raw.md` prompt-IO logs, add `diff_cmd` refs 2026-04-16 17:44:14 -04:00
20260413T192116Z_f851f28_prompt_io.md Add `test_tpt_bind_addrs.py` + fix type-mixing bug 2026-04-14 19:54:14 -04:00
20260413T205048Z_269d939c_prompt_io.md Add `parse_endpoints()` to `_multiaddr` 2026-04-14 19:54:14 -04:00
20260413T205048Z_269d939c_prompt_io.raw.md Condense `.raw.md` prompt-IO logs, add `diff_cmd` refs 2026-04-16 17:44:14 -04:00
20260414T163300Z_befedc49_prompt_io.md Add `prefer_addr()` transport selection to `_api` 2026-04-14 19:54:14 -04:00
20260414T163300Z_befedc49_prompt_io.raw.md Condense `.raw.md` prompt-IO logs, add `diff_cmd` refs 2026-04-16 17:44:14 -04:00
20260417T034918Z_9703210_prompt_io.md Add prompt-IO log for subint spawner design kickoff 2026-04-17 16:48:22 -04:00
20260417T034918Z_9703210_prompt_io.raw.md Add prompt-IO log for subint spawner design kickoff 2026-04-17 16:48:22 -04:00
20260417T035800Z_61a73ba_prompt_io.md Add prompt-io files for "phase-A", fix typos caught by copilot 2026-04-17 18:26:41 -04:00
20260417T035800Z_61a73ba_prompt_io.raw.md Add prompt-io files for "phase-A", fix typos caught by copilot 2026-04-17 18:26:41 -04:00
20260601T231429Z_0e3e008b_prompt_io.md Add `supervise_run_process` to `trionics._subproc` 2026-06-24 18:19:16 -04:00
20260601T231429Z_0e3e008b_prompt_io.raw.md Add `supervise_run_process` to `trionics._subproc` 2026-06-24 18:19:16 -04:00
20260611T175152Z_8526985c_prompt_io.md Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
20260611T175152Z_8526985c_prompt_io.raw.md Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
20260625T232506Z_0a3c48fc_prompt_io.md Add prompt-io provenance for d2-ext + docstring patches 2026-06-28 13:29:02 -04:00
20260625T232506Z_0a3c48fc_prompt_io.raw.md Add prompt-io provenance for d2-ext + docstring patches 2026-06-28 13:29:02 -04:00
20260625T232506Z_3a5cfde0_prompt_io.md Add prompt-io provenance for d2-ext + docstring patches 2026-06-28 13:29:02 -04:00
20260625T232506Z_3a5cfde0_prompt_io.raw.md Add prompt-io provenance for d2-ext + docstring patches 2026-06-28 13:29:02 -04:00
20260702T154255Z_65bf9df5_prompt_io.md Add `tractor.to_actor` one-shot task API subpkg 2026-07-02 12:10:19 -04:00
20260702T154255Z_65bf9df5_prompt_io.raw.md Add `tractor.to_actor` one-shot task API subpkg 2026-07-02 12:10:19 -04:00
README.md Add per-`ctx_key` isolation tests for `maybe_open_context()` 2026-04-06 14:37:47 -04:00

README.md

AI Prompt I/O Log — claude

This directory tracks prompt inputs and model outputs for AI-assisted development using claude (Claude Code).

Policy

Prompt logging follows the NLNet generative AI policy. All substantive AI contributions are logged with: - Model name and version - Timestamps - The prompts that produced the output - Unedited model output (.raw.md files)

Usage

Entries are created by the /prompt-io skill or automatically via /commit-msg integration.

Human contributors remain accountable for all code decisions. AI-generated content is never presented as human-authored work.