Skip to content

The accountable agent: one folder, two locks, a report anyone can re-run - #22

Open
alakanani wants to merge 1 commit into
mainfrom
accountable-agent-2026-11
Open

alakanani wants to merge 1 commit into
mainfrom
accountable-agent-2026-11

Conversation

@alakanani

Copy link
Copy Markdown
Collaborator

First flagship demo from the Direction, Phase 2.

What it is: an agent given exactly one folder, examples/accountable_agent_data, and nothing else. It declares one read permission, fingerprints every file in the folder, and reveals the count, the total characters, and a fingerprint of the whole report. Run it twice and every line matches.

The engine change it needed: a sandboxed run denied every file read until now, so an agent that reads a folder could not run sandboxed at all. New flag: godcode run --sandbox --allow-read DIR scroll.god (repeatable). The host grant and the scroll's permission manifest narrow each other, so the run may read only what both allow. Using --allow-read without --sandbox is a usage error.

Checks, each kept honest by tests/test_accountable_agent.py (8 new tests):

  • With the grant, it runs, and the report fingerprint is recomputed from the files in the test.
  • Without the grant, the sandboxed run is refused.
  • Reaching past the folder is refused, under the sandbox by the host grant and on a plain run by the manifest.
  • The sandboxed report is deterministic across two runs.

Also: docs/accountable-agent.md (including the honest limits: in-process sandbox, host grant is the invoker's act, fingerprint proves the report matches the files as read, not that the files are true), docs/sandbox.md and repo AGENTS.md notes, examples README entry, changelog entry, playground bundle rebuilt.

Verification: full suite 1074 green. check, lint, and sandboxed runs verified by hand. The Spirit counsels drift on the survey rite's declared intent and never fails the run; that counsel is documented, not hidden.

House rules kept: no version numbers and no em dashes in new human-readable text (the em dash scan hits are pre-existing docstring lines, untouched).

Not merged by Luna: awaiting review and merge by KK or the founder, per the charter.

@vercel

vercel Bot commented Nov 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
godcode Ready Ready Preview Nov 4, 2026 11:06am UTC

@koketso2017 koketso2017 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving based on the description and the green suite.

@koketso2017 koketso2017 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving based on the description and the green suite.

This branch was successfully deployed

1 active deployment
Preview — b8e213ab Deployed Nov 4, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants