Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

v0.3: let a record name the agent manifest it ran under

Open
#483 6 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
json, python

Research direction

Read schema/trace-claim.json, schema/trace-token-experimental-v1.json, and schema/trace-claim-v0.3-draft.json, then compare them with Agent Manifest spec §6.3.2 and TRACE §3.1.2. The issue leaves the verification-result and spec-alignment questions open, so the v0.3 shape needs a decision before implementation; done means one agreed manifest representation that satisfies the relevant specs.

Written by the indexing model from the issue text.

Description

A TRACE v0.2 record cannot say which approved agent deployment produced it. schema/trace-claim.json has no manifest field and the top level is additionalProperties: false, so a producer cannot add one. Agent Manifest spec §6.3.2 says TRACE envelopes MUST carry agent_manifest_id and manifest_verification_result, which a v0.2 record cannot satisfy, so the two specs disagree today.

This matters for external receipts too. A PACT receipt or any other authorization receipt can only reach a record through references[], and §3.1.2 says a verifier MUST NOT treat a resolved reference as attested evidence.

Proposal for v0.3: an optional top-level manifest object with id, digest and media_type, covered by the record signature. Two drafts already point this way: ManifestRef in schema/trace-token-experimental-v1.json and runtime.evidence.binds: "manifest-digest" in schema/trace-claim-v0.3-draft.json. One shape should serve both.

Open questions:

  • Does the record carry the verification result, or only the reference, leaving appraisal to the verifier?
  • Should the Agent Manifest §6.3.2 MUST be relaxed to match whatever v0.3 adopts?
Dominant language
Python
Stars
37
Forks
33
Avg merge
1d 4h
Merged PRs (30d)
120

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from agentrust-io/trace-spec

All issues in agentrust-io/trace-spec

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.