bin/mcp-ask-user

filter: Statementstmt 87.6% 92 / 105 Branchbran 72.9% 54 / 74 Conditioncond 55.3% 67 / 121 MC/DCmcdc 29.5% 18 / 61 Subroutinesub 76.4% 13 / 17 Podpod n/a totaltotal 64.5% 244 / 378 CC 77 SCAR 36.3
CC
77
Cov
71%
ask_user
71.8
elicit_form
49.2
answer_question
18.0
CRAP 37.8
« blib/lib/AnyEvent/MCP/Server/JSONL.pm ↑ Summary bin/mcp-http »
1 #!/opt/bin/perl
2  
3 =head1 NAME
4  
5 mcp-ask-user - ask the human questions through MCP
6  
7 =head1 SYNOPSIS
8  
9 mcp-ask-user --stdio
10 mcp-ask-user --name questions --print-url
11  
12 =head1 DESCRIPTION
13  
14 C<mcp-ask-user> lets an assistant ask you a question when it needs
15 clarification or a choice before continuing. C<ask-user> asks one question;
16 C<ask-form> accepts a generic MCP form schema. By default, a local helper
17 displays the form using YAD or a terminal and returns your answer to the
18 caller. C<--ask mcp> uses your MCP
19 client's form interface instead.
20  
21 Each C<ask-user> call asks one question, with up to three suggested answers
22 and a free-text answer field. You can also decline or cancel the question;
23 these are returned as distinct results.
24  
25 Run it as an MCP server connected to your client, or include it among the
26 servers configured in C<mcp-multibroker>. A spawned instance delegates
27 presentation to that broker unless you explicitly give it C<--ask>.
28 The broker's ask mode then selects local prompting or upstream elicitation.
29 See L<AnyEvent::MCP::Intro> for configuring server connections.
30  
31 =head1 FIRST USE
32  
33 Configure your MCP client to launch C<mcp-ask-user --stdio>. Then ask
34 the assistant to call C<ask-user> with these arguments:
35  
36 {
37 "question": "Which part of the project should we inspect first?",
38 "options": [
39 {"label": "Tests"},
40 {"label": "Documentation"}
41 ]
42 }
43  
44 The helper displays a question and returns the chosen or typed answer.
45 By default its dialog appears B<on the server machine>, not necessarily
46 where you are using the MCP client. It needs YAD or a usable C</dev/tty>.
47 For a remote or headless server, C<--ask mcp> works only if the MCP
48 client supports form elicitation; otherwise configure a local helper.
49  
50 With a multibroker prefix C<questions>, call C<questions.ask-user>.
51 A spawned child normally delegates presentation to the broker, whose
52 C<--ask> mode selects local or client-side forms. Independently run
53 servers use their own mode. Decline and cancel are distinct results,
54 not permission grants, and do not cause a fallback prompt.
55  
56 =head1 ASK-USER TOOL
57  
58 In C<mcp> mode, the connected client must support the modern input-challenge
59 protocol and advertise form elicitation. Local prompting also works for
60 legacy callers and clients without form support.
61  
62 =over
63  
64 =item question => $text
65  
66 Required nonempty question, up to 4096 characters.
67  
68 =item id => $id
69  
70 Question identifier, defaulting to C<question>. Starts with an ASCII
71 letter or underscore, followed by letters, digits, underscores or hyphens,
72 with a total length of at most 64 characters.
73  
74 =item header => $text
75  
76 Optional form heading, up to 64 characters.
77  
78 =item options => [{ label => $label, description => $description }...]
79  
80 Up to three suggested answers. Labels must be nonempty, distinct and no
81 longer than 100 characters. Descriptions are optional, up to 512 characters.
82 Free text remains available whether or not options are supplied.
83  
84 =back
85  
86 An accepted response returns C<{ id, status, answer, source }>, with
87 C<status> equal to C<answered> and C<source> equal to C<choice> or
88 C<free_text>. Nonblank free text takes precedence over a selected option;
89 it is limited to 4096 characters. Decline and cancel return C<{ id, status }>
90 with C<status> equal to C<declined> or C<cancelled>, without an answer.
91 An accepted form containing neither an answer nor a selected option is
92 a tool error.
93  
94 Input continuations expire after 30 minutes, are bound to the original call
95 and are consumed once. These results use C<structuredContent> and matching
96 JSON text; see L<AnyEvent::MCP::Server::Request/result>.
97  
98 As a spawned multibroker stdio child, the server requests idle shutdown after
99 five minutes without MCP requests. Outstanding input continuations prevent
100 shutdown until consumed or expired; the idle request is retried afterward.
101 Directly connected clients and HTTP listeners are unaffected.
102  
103 =head1 ASK-FORM TOOL
104  
105 C<ask-form> exposes the form interface directly when you need several fields
106 or types other than a single text answer. For example:
107  
108 {
109 "message": "Choose the download settings.",
110 "requestedSchema": {
111 "type": "object",
112 "required": ["directory", "overwrite"],
113 "properties": {
114 "directory": {"type": "string", "title": "Destination directory"},
115 "overwrite": {"type": "boolean", "title": "Overwrite existing files"}
116 }
117 }
118 }
119  
120 =over
121  
122 =item message => $text
123  
124 Required text explaining what the form asks and why.
125  
126 =item requestedSchema => { type => "object", properties => { ... }, ... }
127  
128 Required MCP form schema. Field names identify the returned values.
129 The tool forwards the schema unchanged, with C<mode> set to C<form>.
130 The selected renderer determines supported schema features and validates
131 the entered values. The default local helper supports its documented flat
132 form subset; unsupported features fail explicitly. Native mode forwards
133 the schema to the MCP client without imposing the local helper's limits.
134  
135 =back
136  
137 The result is the ordinary elicitation response, in C<structuredContent>
138 and matching JSON text:
139  
140 {"action":"accept","content":{"directory":"/tmp/maps","overwrite":false}}
141 {"action":"decline"}
142 {"action":"cancel"}
143  
144 The tool checks the response action and requires object content on acceptance;
145 it does not interpret field names or revalidate content against the schema.
146 Boolean and numeric values retain their JSON types. Decline and cancel
147 carry no content and never trigger a fallback prompt. Native continuations
148 have the same 30-minute lifetime and one-use, original-call binding as
149 C<ask-user>.
150  
151 =head1 OPTIONS
152  
153 Shared switches are documented in
154 L<AnyEvent::MCP::Server::Simple/COMMON COMMAND-LINE OPTIONS>.
155 HTTP is the default transport. The following shared switch controls form prompting.
156  
157 =over
158  
159 =item --ask MODE
160  
161 Choose human prompting mode: C<helper> (default standalone), C<tty>,
162 C<yad>, C<mcp>, C<auto> or C<none>. C<helper> launches
163 C<anyevent-mcp-form-elicitation> or
164 C<PERL_ANYEVENT_MCP_ELICITATION_HELPER>; C<tty>/C<yad> force that local
165 interface without fallback. C<mcp> asks client; C<auto> uses client
166 forms when advertised, otherwise local helper; C<none> automatically
167 declines. Declines never retry
168 via another interface. Explicit C<--ask> overrides inherited
169 C<PERL_ANYEVENT_MCP_PERMISSION_ASK>; spawned multibroker instances
170 default to client mode. Clients that advertise but silently decline
171 native forms require C<--ask helper>.
172  
173 =back
174  
175 =cut
176  
177 6 ▶use common::sense;
Subroutine BEGIN: called CC=1 SCAR=0.0
178  
179 6 ▶use JSON::XS ();
Subroutine BEGIN: called CC=1 SCAR=0.0
180  
181 6 ▶use AnyEvent ();
Subroutine BEGIN: called CC=1 SCAR=0.0
182 6 ▶use AnyEvent::MCP ();
Subroutine BEGIN: called CC=1 SCAR=0.0
183 6 ▶use AnyEvent::MCP::Helper ();
Subroutine BEGIN: called CC=1 SCAR=0.0
184  
185 6 ▶use AnyEvent::MCP::Server::Simple;
Subroutine BEGIN: called CC=1 SCAR=0.0
186  
187 6 mcp_permissions undef; # human-input tools do not use application permissions
188  
189 6 my $options = mcp_getoptions
190 {
191 usage => "Usage: $0 [OPTION]...\n",
192 description => "Ask a human question or display an MCP form, locally or through native elicitation.",
193 examples => " $0 --stdio\n $0 --ask mcp --name questions --print-url",
194 }
195 ;
196  
197 5 my $ask_mode = delete $options->{ask};
198 $ask_mode //= $ENV{PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL} eq "stdio"
199 5 ▶ ? "mcp" : $ENV{PERL_ANYEVENT_MCP_PERMISSION_ASK} || "helper";
Branch: 1 branch
BranchTrueFalseTotal
$ENV{'PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL'} eq 'stdio' ? : 1 1 2
Condition75%3/4
$ask_mode //= $ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio" ? "mcp" : $ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"} || "helper"
l!l
32
$ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"} or "helper"
l!l
01
MC/DC100%1/1
$ask_mode //= $ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio" ? "mcp" : $ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"} || "helper"
$ask_mode
MC/DC0%0/1
$ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"} or "helper"
$ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"}
Truth table100%2/2
A
A= $ask_mode
Aresult
11
00
Truth table50%1/2
A
A= $ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"}
Aresult
11
00
200 5 ▶$ask_mode =~ /\A(?:helper|tty|yad|auto|mcp|none)\z/ or die "--ask must be helper, tty, yad, auto, mcp, or none\n";
Branch: 1 branch
BranchTrueFalseTotal
$ask_mode =~ /\A(?:helper|tty|yad|auto|mcp|none)\z/u or die "--ask must be helper, tty, yad, auto, mcp, or none\n" 5 0 5
201  
202 5 my %pending;
203  
204 42 ▶sub _call {
Subroutine _call: called CC=1 SCAR=0.0
205 42 my ($req) = @_;
206  
207 42 my %params = %{$req->{params}};
208 42 delete @params{qw(inputResponses requestState _meta)};
209 # _meta is per-request context, not stable operation identity: retries can
210 # carry different client capabilities, progress tokens and clientInfo.
211 # bind the one-use token to the protocol version and semantic parameters.
212 42 JSON::XS->new->canonical->encode ([$req->{protocol_version}, $req->{method}, \%params])
213 }
214  
215 12 ▶sub answer_question {
Subroutine answer_question: called CC=14 SCAR=28.9
216 12 my ($req, $id, $labels, $response) = @_;
217  
218 12 ▶ ref $response eq "HASH"
Branch: 1 branch
BranchTrueFalseTotal
ref $response eq "HASH" or return $req->error("Invalid question response") 12 0 12
219 or return $req->error ("Invalid question response");
220  
221 12 my $action = $response->{action};
222 12 ▶ return $req->result ({ id => $id, status => "declined" }) if $action eq "decline";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "decline" 2 10 12
223 10 ▶ return $req->result ({ id => $id, status => "cancelled" }) if $action eq "cancel";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "cancel" 1 9 10
224 9 ▶ $action eq "accept" && ref $response->{content} eq "HASH"
Branch: 1 branch
BranchTrueFalseTotal
$action eq "accept" and ref $response->{"content"} eq "HASH" or return $req->error("Invalid question response action") 9 0 9
Condition33%1/3
$action eq "accept" and ref $response->{"content"} eq "HASH"
!ll&&!rl&&r
009
MC/DC0%0/2
$action eq "accept" and ref $response->{"content"} eq "HASH"
$action eq "accept" ref $response->{"content"} eq "HASH"
Truth table33%1/3
A and B
A= $action eq "accept"B= ref $response->{"content"} eq "HASH"
ABresult
0X0
100
111
225 or return $req->error ("Invalid question response action");
226  
227 9 my $content = $response->{content};
228 9 my $text = $content->{free_text};
229 9 my $choice = $content->{choice};
230 9 ▶ return $req->error ("Invalid free-text answer")
Branch: 1 branch
BranchTrueFalseTotal
if defined $text and ref $text || length $text > 4096 0 9 9
Condition50%3/6
defined $text and ref $text || length $text > 4096
!ll&&!rl&&r
720
ref $text or length $text > 4096
l!l&&r!l&&!r
002
MC/DC0%0/3
defined $text and ref $text || length $text > 4096
defined $text ref $text length $text > 4096
Truth table50%2/4
A and B or C
A= defined $textB= ref $textC= length $text > 4096
ABCresult
0XX0
1000
11X1
1011
231 if defined $text && (ref $text || length $text > 4096);
232 return $req->error ("Invalid selected answer")
233 9 ▶ if defined $choice && (ref $choice || !$labels->{$choice});
Branch: 1 branch
BranchTrueFalseTotal
if defined $choice and ref $choice || !$labels->{$choice} 0 9 9
Condition50%3/6
defined $choice and ref $choice || !$labels->{$choice}
!ll&&!rl&&r
270
ref $choice or not $labels->{$choice}
l!l&&r!l&&!r
007
MC/DC0%0/3
defined $choice and ref $choice || !$labels->{$choice}
defined $choice ref $choice not $labels->{$choice}
Truth table50%2/4
A and B or not(C)
A= defined $choiceB= ref $choiceC= not $labels->{$choice}
ABCresult
0XX0
1000
11X1
1011
234  
235 9 ▶ my $source = $text =~ /\S/ ? "free_text"
Branch: 2 branches
BranchTrueFalseTotal
$text =~ /\S/u ? : 2 7 9
defined $choice ? : 6 1 7
236 : defined $choice ? "choice"
237 : return $req->error ("No answer supplied");
238  
239 return $req->result ({
240 id => $id,
241 status => "answered",
242 8 answer => $content->{$source},
243 source => $source,
244 });
245 }
246  
247 54 ▶sub elicit_form {
Subroutine elicit_form: called CC=19 SCAR=39.0
248 54 my ($req, $form, $key, $done) = @_;
249  
250 54 my $state = $req->{params}{requestState};
251 54 ▶ if (defined $state || exists $req->{params}{inputResponses}) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $state or exists $req->{"params"}{"inputResponses"}) 25 29 54
Condition66%2/3
defined $state or exists $req->{"params"}{"inputResponses"}
l!l&&r!l&&!r
25029
MC/DC50%1/2
defined $state or exists $req->{"params"}{"inputResponses"}
defined $state exists $req->{"params"}{"inputResponses"}
Truth table66%2/3
A or B
A= defined $stateB= exists $req->{"params"}{"inputResponses"}
ABresult
1X1
011
000
252 25 ▶ my $entry = delete $pending{$state}
Branch: 1 branch
BranchTrueFalseTotal
if defined $state and not ref $state 25 0 25
Condition33%1/3
defined $state and not ref $state
!ll&&!rl&&r
0025
MC/DC0%0/2
defined $state and not ref $state
defined $state not ref $state
Truth table33%1/3
A and not(B)
A= defined $stateB= not ref $state
ABresult
0X0
100
111
253 if defined $state && !ref $state;
254 25 ▶ $entry && $entry->{call} eq _call ($req)
Branch: 1 branch
BranchTrueFalseTotal
$entry and $entry->{"call"} eq _call($req) or return $req->error("Invalid or expired $key continuation") 18 7 25
Condition100%3/3
$entry and $entry->{"call"} eq _call($req)
!ll&&!rl&&r
4318
MC/DC100%2/2
$entry and $entry->{"call"} eq _call($req)
$entry $entry->{"call"} eq _call($req)
Truth table100%3/3
A and B
A= $entryB= $entry->{"call"} eq _call($req)
ABresult
0X0
100
111
255 or return $req->error ("Invalid or expired $key continuation");
256  
257 18 return $done->($req, $req->{params}{inputResponses}{$key});
258 }
259  
260 29 ▶ return $done->($req, { action => "decline" }) if $ask_mode eq "none";
Branch: 1 branch
BranchTrueFalseTotal
if $ask_mode eq "none" 2 27 29
261  
262 27 my $caps = $req->{params}{_meta}{"io.modelcontextprotocol/clientCapabilities"};
263 my $native = $req->{protocol_version} ge "2026"
264 && ref $caps eq "HASH" && ref $caps->{elicitation} eq "HASH"
265 27 ▶ && (!keys %{$caps->{elicitation}} || ref $caps->{elicitation}{form} eq "HASH");
Condition91%11/12
$req->{'protocol_version'} ge '2026' && ref $caps eq 'HASH' && ref $caps->{'elicitation'} eq 'HASH' && (!keys(%{$$caps{'elicitation'};}) || ref $caps->{'elicitation'}{'form'} eq 'HASH')
!ll&&!rl&&r
5121
$req->{"protocol_version"} ge 2026 and ref $caps eq "HASH" and ref $caps->{"elicitation"} eq "HASH"
!ll&&!rl&&r
2322
$req->{"protocol_version"} ge 2026 and ref $caps eq "HASH"
!ll&&!rl&&r
2025
not keys %{$$caps{"elicitation"};} or ref $caps->{"elicitation"}{"form"} eq "HASH"
l!l&&r!l&&!r
4171
MC/DC80%4/5
$req->{'protocol_version'} ge '2026' && ref $caps eq 'HASH' && ref $caps->{'elicitation'} eq 'HASH' && (!keys(%{$$caps{'elicitation'};}) || ref $caps->{'elicitation'}{'form'} eq 'HASH')
$req->{"protocol_version"} ge 2026 ref $caps eq "HASH" ref $caps->{"elicitation"} eq "HASH" not keys %{$$caps{"elicitation"};} ref $caps->{"elicitation"}{"form"} eq "HASH"
Truth table83%5/6
A and B and C && not(D) or E
A= $req->{"protocol_version"} ge 2026B= ref $caps eq "HASH"C= ref $caps->{"elicitation"} eq "HASH"D= not keys %{$$caps{"elicitation"};}E= ref $caps->{"elicitation"}{"form"} eq "HASH"
ABCDEresult
0XXXX0
10XXX0
110XX0
111000
1111X1
111011
266  
267 27 ▶ if ($ask_mode =~ /\A(?:helper|tty|yad)\z/ || $ask_mode eq "auto" && !$native) {
Branch: 1 branch
BranchTrueFalseTotal
if ($ask_mode =~ /\A(?:helper|tty|yad)\z/u or $ask_mode eq "auto" and not $native) 0 27 27
Condition33%2/6
$ask_mode =~ /\A(?:helper|tty|yad)\z/u or $ask_mode eq "auto" and not $native
l!l&&r!l&&!r
0027
$ask_mode eq "auto" and not $native
!ll&&!rl&&r
2700
MC/DC0%0/3
$ask_mode =~ /\A(?:helper|tty|yad)\z/u or $ask_mode eq "auto" and not $native
$ask_mode =~ /\A(?:helper|tty|yad)\z/u $ask_mode eq "auto" not $native
Truth table25%1/4
A or B and not(C)
A= $ask_mode =~ /\A(?:helper|tty|yad)\z/uB= $ask_mode eq "auto"C= not $native
ABCresult
1XX1
0111
00X0
0100
268 my $job = AnyEvent::MCP::Helper->new (
269 helper => $ask_mode eq "tty" || $ask_mode eq "yad"
270 ? ["anyevent-mcp-form-elicitation", "--$ask_mode"]
271 0 ▶ : $ENV{PERL_ANYEVENT_MCP_ELICITATION_HELPER} || "anyevent-mcp-form-elicitation",
Branch: 1 branch
BranchTrueFalseTotal
$ask_mode eq 'tty' || $ask_mode eq 'yad' ? : 0 0 0
Condition0%0/5
$ask_mode eq "tty" or $ask_mode eq "yad"
l!l&&r!l&&!r
000
$ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"} or "anyevent-mcp-form-elicitation"
l!l
00
MC/DC0%0/2
$ask_mode eq "tty" or $ask_mode eq "yad"
$ask_mode eq "tty" $ask_mode eq "yad"
MC/DC0%0/1
$ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"} or "anyevent-mcp-form-elicitation"
$ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"}
Truth table0%0/3
A or B
A= $ask_mode eq "tty"B= $ask_mode eq "yad"
ABresult
1X1
011
000
Truth table0%0/2
A
A= $ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"}
Aresult
11
00
272 timeout => 1800,
273 );
274 0 my $old_cancel = $req->{on_cancel};
275 0 ▶ $req->{on_cancel} = sub { $job->cancel; $old_cancel->(@_) if $old_cancel };
Subroutine __ANON__: not called CC=2 SCAR=17.9
Branch: 1 branch
BranchTrueFalseTotal
if $old_cancel 0 0 0
276 0 ▶ $job->ask ($form, sub {
Subroutine __ANON__: not called CC=3 SCAR=24.8
277 0 my ($success, $response) = @_;
278  
279 0 ▶ return if $req->{finished};
Branch: 1 branch
BranchTrueFalseTotal
if $req->{"finished"} 0 0 0
280 0 ▶ return $req->error ($response) unless $success;
Branch: 1 branch
BranchTrueFalseTotal
unless $success 0 0 0
281 0 $done->($req, $response);
282 0 });
283 0 return;
284 }
285 27 ▶ $native or return $req->error ("MCP form elicitation is unavailable for this client");
Branch: 1 branch
BranchTrueFalseTotal
$native or return $req->error("MCP form elicitation is unavailable for this client") 21 6 27
286  
287 21 my $token = "ae-mcp-$key:" . unpack "H*", AnyEvent::MCP::random_bytes 32;
288 21 my $entry = $pending{$token} = { call => _call ($req) };
289 0 ▶ $entry->{timer} = AnyEvent->timer (after => 1800, cb => sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
290 0 delete $pending{$token};
291 21 });
292  
293 21 $req->reply ({
294 resultType => "input_required",
295 requestState => $token,
296 inputRequests => {
297 $key => {
298 method => "elicitation/create",
299 params => $form,
300 },
301 },
302 });
303 }
304  
305 33 ▶sub ask_user {
Subroutine ask_user: called CC=30 SCAR=42.7
306 33 my ($req, $args) = @_;
307  
308 33 ▶ my $id = $args->{id} // "question";
Condition100%2/2
$args->{"id"} // "question"
l!l
321
MC/DC100%1/1
$args->{"id"} // "question"
$args->{"id"}
Truth table100%2/2
A
A= $args->{"id"}
Aresult
11
00
309 33 my $question = $args->{question};
310 33 ▶ my $options = $args->{options} // [];
Condition100%2/2
$args->{"options"} // []
l!l
312
MC/DC100%1/1
$args->{"options"} // []
$args->{"options"}
Truth table100%2/2
A
A= $args->{"options"}
Aresult
11
00
311  
312 33 ▶ !ref $id && $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/
Branch: 1 branch
BranchTrueFalseTotal
not ref $id and $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u or return $req->error("Invalid question id") 33 0 33
Condition33%1/3
not ref $id and $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u
!ll&&!rl&&r
0033
MC/DC0%0/2
not ref $id and $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u
not ref $id $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u
Truth table33%1/3
not(A) and B
A= not ref $idB= $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u
ABresult
0X0
100
111
313 or return $req->error ("Invalid question id");
314 33 ▶ defined $question && !ref $question && $question =~ /\S/ && length $question <= 4096
Branch: 1 branch
BranchTrueFalseTotal
defined $question and not ref $question and $question =~ /\S/u and length $question <= 4096 or return $req->error("Question must be a nonempty string") 33 0 33
Condition33%3/9
defined $question and not ref $question and $question =~ /\S/u and length $question <= 4096
!ll&&!rl&&r
0033
defined $question and not ref $question and $question =~ /\S/u
!ll&&!rl&&r
0033
defined $question and not ref $question
!ll&&!rl&&r
0033
MC/DC0%0/4
defined $question and not ref $question and $question =~ /\S/u and length $question <= 4096
defined $question not ref $question $question =~ /\S/u length $question <= 4096
Truth table20%1/5
A and not(B) and C and D
A= defined $questionB= not ref $questionC= $question =~ /\S/uD= length $question <= 4096
ABCDresult
0XXX0
10XX0
110X0
11100
11111
315 or return $req->error ("Question must be a nonempty string");
316 return $req->error ("Invalid question header")
317 33 ▶ if defined $args->{header} && (ref $args->{header} || length $args->{header} > 64);
Branch: 1 branch
BranchTrueFalseTotal
if defined $args->{"header"} and ref $args->{"header"} || length $args->{"header"} > 64 0 33 33
Condition50%3/6
defined $args->{"header"} and ref $args->{"header"} || length $args->{"header"} > 64
!ll&&!rl&&r
3300
ref $args->{"header"} or length $args->{"header"} > 64
l!l&&r!l&&!r
0030
MC/DC0%0/3
defined $args->{"header"} and ref $args->{"header"} || length $args->{"header"} > 64
defined $args->{"header"} ref $args->{"header"} length $args->{"header"} > 64
Truth table50%2/4
A and B or C
A= defined $args->{"header"}B= ref $args->{"header"}C= length $args->{"header"} > 64
ABCresult
0XX0
1000
11X1
1011
318 33 ▶ ref $options eq "ARRAY" && @$options <= 3
Branch: 1 branch
BranchTrueFalseTotal
ref $options eq "ARRAY" and @$options <= 3 or return $req->error("Invalid answer options") 33 0 33
Condition33%1/3
ref $options eq "ARRAY" and @$options <= 3
!ll&&!rl&&r
0033
MC/DC0%0/2
ref $options eq "ARRAY" and @$options <= 3
ref $options eq "ARRAY" @$options <= 3
Truth table33%1/3
A and B
A= ref $options eq "ARRAY"B= @$options <= 3
ABresult
0X0
100
111
319 or return $req->error ("Invalid answer options");
320  
321 33 my %labels;
322 33 for my $option (@$options) {
323 ref $option eq "HASH" && defined $option->{label}
324 && !ref $option->{label} && $option->{label} =~ /\S/
325 && length $option->{label} <= 100
326 && (!defined $option->{description}
327 || !ref $option->{description} && length $option->{description} <= 512)
328 62 ▶ && !$labels{$option->{label}}++
Branch: 1 branch
BranchTrueFalseTotal
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u and length $option->{"label"} <= 100 and !defined($option->{"description"}) || !ref($option->{"description"}) && length $option->{"description"} <= 512 and not $labels{$option->{"label"}}++ or return $req->error("Invalid answer option") 61 1 62
Condition41%10/24
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u and length $option->{"label"} <= 100 and !defined($option->{"description"}) || !ref($option->{"description"}) && length $option->{"description"} <= 512 and not $labels{$option->{"label"}}++
!ll&&!rl&&r
0161
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u and length $option->{"label"} <= 100 and !defined($option->{"description"}) || !ref($option->{"description"}) && length $option->{"description"} <= 512
!ll&&!rl&&r
0062
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u and length $option->{"label"} <= 100
!ll&&!rl&&r
0062
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u
!ll&&!rl&&r
0062
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"}
!ll&&!rl&&r
0062
ref $option eq "HASH" and defined $option->{"label"}
!ll&&!rl&&r
0062
not defined $option->{"description"} or not ref $option->{"description"} and length $option->{"description"} <= 512
l!l&&r!l&&!r
2600
not ref $option->{"description"} and length $option->{"description"} <= 512
!ll&&!rl&&r
0060
MC/DC11%1/9
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u and length $option->{"label"} <= 100 and !defined($option->{"description"}) || !ref($option->{"description"}) && length $option->{"description"} <= 512 and not $labels{$option->{"label"}}++
ref $option eq "HASH" defined $option->{"label"} not ref $option->{"label"} $option->{"label"} =~ /\S/u length $option->{"label"} <= 100 not defined $option->{"description"} not ref $option->{"description"} length $option->{"description"} <= 512 not $labels{$option->{"label"}}++
Truth table27%3/11
A and B and not(C) and D and E and not(F) or not(G) and H and not(I)
A= ref $option eq "HASH"B= defined $option->{"label"}C= not ref $option->{"label"}D= $option->{"label"} =~ /\S/uE= length $option->{"label"} <= 100F= not defined $option->{"description"}G= not ref $option->{"description"}H= length $option->{"description"} <= 512I= not $labels{$option->{"label"}}++
ABCDEFGHIresult
0XXXXXXXX0
10XXXXXXX0
110XXXXXX0
1110XXXXX0
11110XXXX0
1111100XX0
11111010X0
111111XX00
1111101100
111111XX11
1111101111
329 or return $req->error ("Invalid answer option");
330 }
331  
332 my $schema = {
333 type => "object",
334 properties => {
335 (@$options ? (choice => {
336 type => "string",
337 title => "Select an answer (or use free text)",
338 32 ▶ enum => [map $_->{label}, @$options],
Branch: 3 branches
BranchTrueFalseTotal
@$options ? : 30 2 32
@$options ? : 30 2 32
@$options ? : 30 2 32
339 }) : ()),
340 free_text => {
341 type => "string",
342 title => @$options ? "Alternative answer (optional)" : "Your answer",
343 maxLength => 4096,
344 },
345 },
346 (@$options ? () : (required => ["free_text"])),
347 };
348 my $message = join "\n",
349 (length $args->{header} ? $args->{header} : ()),
350 $question,
351 32 ▶ map { $_->{label} . (length $_->{description} ? " - $_->{description}" : "") } @$options;
Branch: 2 branches
BranchTrueFalseTotal
length $args->{'header'} ? : 30 2 32
length $_->{'description'} ? : 60 0 60
352  
353 32 my $form = { mode => "form", message => $message, requestedSchema => $schema };
354 AE::log debug => "ask-user ask-user $id"
355 32 ▶ unless defined $req->{params}{requestState};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $req->{"params"}{"requestState"} 17 15 32
356 12 ▶ elicit_form ($req, $form, question => sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
357 12 answer_question ($_[0], $id, \%labels, $_[1]);
358 32 });
359 }
360  
361 8 ▶sub answer_form {
Subroutine answer_form: called CC=8 SCAR=20.8
362 8 my ($req, $response) = @_;
363  
364 ref $response eq "HASH" && defined $response->{action} && !ref $response->{action}
365 8 ▶ or return $req->error ("Invalid form response");
Branch: 1 branch
BranchTrueFalseTotal
ref $response eq "HASH" and defined $response->{"action"} and not ref $response->{"action"} or return $req->error("Invalid form response") 7 1 8
Condition66%4/6
ref $response eq "HASH" and defined $response->{"action"} and not ref $response->{"action"}
!ll&&!rl&&r
107
ref $response eq "HASH" and defined $response->{"action"}
!ll&&!rl&&r
017
MC/DC33%1/3
ref $response eq "HASH" and defined $response->{"action"} and not ref $response->{"action"}
ref $response eq "HASH" defined $response->{"action"} not ref $response->{"action"}
Truth table50%2/4
A and B and not(C)
A= ref $response eq "HASH"B= defined $response->{"action"}C= not ref $response->{"action"}
ABCresult
0XX0
10X0
1100
1111
366  
367 7 my $action = $response->{action};
368 7 ▶ return $req->result ({ action => $action }) if $action eq "decline" || $action eq "cancel";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "decline" or $action eq "cancel" 3 4 7
Condition100%3/3
$action eq "decline" or $action eq "cancel"
l!l&&r!l&&!r
214
MC/DC100%2/2
$action eq "decline" or $action eq "cancel"
$action eq "decline" $action eq "cancel"
Truth table100%3/3
A or B
A= $action eq "decline"B= $action eq "cancel"
ABresult
1X1
011
000
369 4 ▶ $action eq "accept" && ref $response->{content} eq "HASH"
Branch: 1 branch
BranchTrueFalseTotal
$action eq "accept" and ref $response->{"content"} eq "HASH" or return $req->error("Invalid form response action") 2 2 4
Condition100%3/3
$action eq "accept" and ref $response->{"content"} eq "HASH"
!ll&&!rl&&r
112
MC/DC100%2/2
$action eq "accept" and ref $response->{"content"} eq "HASH"
$action eq "accept" ref $response->{"content"} eq "HASH"
Truth table100%3/3
A and B
A= $action eq "accept"B= ref $response->{"content"} eq "HASH"
ABresult
0X0
100
111
370 or return $req->error ("Invalid form response action");
371  
372 2 $req->result ({ action => $action, content => $response->{content} });
373 }
374  
375 24 ▶sub ask_form {
Subroutine ask_form: called CC=7 SCAR=19.7
376 24 my ($req, $args) = @_;
377  
378 defined $args->{message} && !ref $args->{message}
379 24 ▶ or return $req->error ("Form needs a message");
Branch: 1 branch
BranchTrueFalseTotal
defined $args->{"message"} and not ref $args->{"message"} or return $req->error("Form needs a message") 23 1 24
Condition66%2/3
defined $args->{"message"} and not ref $args->{"message"}
!ll&&!rl&&r
0123
MC/DC50%1/2
defined $args->{"message"} and not ref $args->{"message"}
defined $args->{"message"} not ref $args->{"message"}
Truth table66%2/3
A and not(B)
A= defined $args->{"message"}B= not ref $args->{"message"}
ABresult
0X0
100
111
380  
381 23 my $schema = $args->{requestedSchema};
382 23 ▶ ref $schema eq "HASH" && $schema->{type} eq "object" && ref $schema->{properties} eq "HASH"
Branch: 1 branch
BranchTrueFalseTotal
ref $schema eq "HASH" and $schema->{"type"} eq "object" and ref $schema->{"properties"} eq "HASH" or return $req->error("Form needs an object schema with properties") 22 1 23
Condition66%4/6
ref $schema eq "HASH" and $schema->{"type"} eq "object" and ref $schema->{"properties"} eq "HASH"
!ll&&!rl&&r
1022
ref $schema eq "HASH" and $schema->{"type"} eq "object"
!ll&&!rl&&r
0122
MC/DC33%1/3
ref $schema eq "HASH" and $schema->{"type"} eq "object" and ref $schema->{"properties"} eq "HASH"
ref $schema eq "HASH" $schema->{"type"} eq "object" ref $schema->{"properties"} eq "HASH"
Truth table50%2/4
A and B and C
A= ref $schema eq "HASH"B= $schema->{"type"} eq "object"C= ref $schema->{"properties"} eq "HASH"
ABCresult
0XX0
10X0
1100
1111
383 or return $req->error ("Form needs an object schema with properties");
384  
385 AE::log debug => "ask-user ask-form"
386 22 ▶ unless defined $req->{params}{requestState};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $req->{"params"}{"requestState"} 12 10 22
387 elicit_form ($req, {
388 mode => "form",
389 message => $args->{message},
390 22 requestedSchema => $schema,
391 }, form => \&answer_form);
392 }
393  
394 5 mcp_tool ask_user =>
395 "Ask human question; await answer or distinct decline/cancel status. Configured mode uses local helper or native MCP elicitation.",
396 {
397 type => "object",
398 required => ["question"],
399 properties => {
400 id => { type => "string", description => "Stable question ID (default: question)" },
401 header => { type => "string", description => "Optional short heading" },
402 question => { type => "string", description => "Question shown to human" },
403 options => {
404 type => "array",
405 maxItems => 3,
406 description => "Up to 3 suggested answers; free text always allowed.",
407 items => {
408 type => "object",
409 required => ["label"],
410 properties => {
411 label => { type => "string" },
412 description => { type => "string" },
413 },
414 },
415 },
416 },
417 },
418 \&ask_user;
419  
420 5 mcp_tool ask_form =>
421 "Ask human to fill MCP form. Takes message/requestedSchema; returns accept/content, decline or cancel. Configured mode: local helper or native elicitation; local helper supports limited schema subset.",
422 {
423 type => "object",
424 required => ["message", "requestedSchema"],
425 additionalProperties => JSON::XS::false,
426 properties => {
427 message => {
428 type => "string",
429 description => "Form purpose and explanation",
430 },
431 requestedSchema => {
432 type => "object",
433 description => "MCP form schema: object with named properties",
434 },
435 },
436 },
437 \&ask_form;
438  
439 mcp_config
440 idle_exit => 300,
441 0 ▶ on_idle_shutdown => sub { !%pending },
Subroutine __ANON__: not called CC=1 SCAR=6.9
442 5 server_name => "mcp-ask-user",
443 server_version => $AnyEvent::MCP::VERSION,
444 short_instructions => "Ask human when input needed: ask-user for question, ask-form for fields. Decline/cancel are not answers.",
445 instructions => "Use only when human input needed. ask-user: question, choices, free text. ask-form: MCP form schema. Decline/cancel are not answers.";
446  
447 5 mcp_start %$options;
« blib/lib/AnyEvent/MCP/Server/JSONL.pm ↑ Summary bin/mcp-http »