agent-contracts/examples/v1.1/research-assistant.yaml at main · ghzhost/agent-contracts · GitHub

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
version: 1.1

system:
  name: Scientific Literature Research Assistant
  purpose: Searches scientific preprint repositories and synthesizes domain literature reviews
  version: "1.2.0"

domain: research

capabilities:
  - name: literature_synthesis
    description: Summarizes key findings across multiple peer-reviewed papers

resources:
  - name: arxiv_api
    type: external_api
    access: read
  - name: europe_pmc_api
    type: external_api
    access: read

inputs:
  - name: research_query
    type: string
    required: true
  - name: max_papers
    type: number
    required: false

outputs:
  - name: literature_review
    type: markdown_report
  - name: citation_list
    type: bibtex

permissions:
  - resource: arxiv_api
    actions:
      - search
      - query
  - resource: europe_pmc_api
    actions:
      - search
      - query

constraints:
  - type: max_results
    maximum: 50
  - type: timeout
    maximum: 30
    unit: seconds

side_effects: []
approvals: []

dependencies:
  - name: arxiv_api
    type: external_api
    required: true
  - name: europe_pmc_api
    type: external_api
    required: false

state:
  persistence: none

recovery:
  strategy: fallback
  details: Falls back to local paper cache if remote API fails

replay:
  mode: idempotent

observability:
  level: basic
  sinks: ["stdout"]

risk:
  level: low
  category: misinformation_risk