bin/mcp-ask-user

filter: Statementstmt 97.0% 98 / 101 Branchbran 81.9% 59 / 72 Conditioncond 63.6% 77 / 121 MC/DCmcdc 40.9% 25 / 61 Subroutinesub 87.5% 14 / 16 Podpod n/a totaltotal 73.5% 273 / 371 CC 76 SCAR 34.1
CC
76
Cov
80%
ask_user
68.0
elicit_form
19.6
answer_question
15.7
CRAP 30.3
« 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 =head1 ASK-FORM TOOL
99  
100 C<ask-form> exposes the form interface directly when you need several fields
101 or types other than a single text answer. For example:
102  
103 {
104 "message": "Choose the download settings.",
105 "requestedSchema": {
106 "type": "object",
107 "required": ["directory", "overwrite"],
108 "properties": {
109 "directory": {"type": "string", "title": "Destination directory"},
110 "overwrite": {"type": "boolean", "title": "Overwrite existing files"}
111 }
112 }
113 }
114  
115 =over
116  
117 =item message => $text
118  
119 Required text explaining what the form asks and why.
120  
121 =item requestedSchema => { type => "object", properties => { ... }, ... }
122  
123 Required MCP form schema. Field names identify the returned values.
124 The tool forwards the schema unchanged, with C<mode> set to C<form>.
125 The selected renderer determines supported schema features and validates
126 the entered values. The default local helper supports its documented flat
127 form subset; unsupported features fail explicitly. Native mode forwards
128 the schema to the MCP client without imposing the local helper's limits.
129  
130 =back
131  
132 The result is the ordinary elicitation response, in C<structuredContent>
133 and matching JSON text:
134  
135 {"action":"accept","content":{"directory":"/tmp/maps","overwrite":false}}
136 {"action":"decline"}
137 {"action":"cancel"}
138  
139 The tool checks the response action and requires object content on acceptance;
140 it does not interpret field names or revalidate content against the schema.
141 Boolean and numeric values retain their JSON types. Decline and cancel
142 carry no content and never trigger a fallback prompt. Native continuations
143 have the same 30-minute lifetime and one-use, original-call binding as
144 C<ask-user>.
145  
146 =head1 OPTIONS
147  
148 Shared switches are documented in
149 L<AnyEvent::MCP::Server::Simple/COMMON COMMAND-LINE OPTIONS>.
150 HTTP is the default transport. The following switch is application-specific.
151  
152 =over
153  
154 =item --ask MODE
155  
156 Choose human prompting mode: C<helper> (default standalone), C<tty>,
157 C<yad>, C<mcp> or C<auto>. C<helper> launches
158 C<anyevent-mcp-form-elicitation> or
159 C<PERL_ANYEVENT_MCP_ELICITATION_HELPER>; C<tty>/C<yad> force that local
160 interface without fallback. C<mcp> asks client; C<auto> uses client
161 forms when advertised, otherwise local helper. Declines never retry
162 via another interface. Explicit C<--ask> overrides inherited
163 C<PERL_ANYEVENT_MCP_PERMISSION_ASK>; spawned multibroker instances
164 default to client mode. Clients that advertise but silently decline
165 native forms require C<--ask helper>.
166  
167 =back
168  
169 =cut
170  
171 17 ▶use common::sense;
Subroutine BEGIN: called CC=1 SCAR=0.0
172  
173 17 ▶use JSON::XS ();
Subroutine BEGIN: called CC=1 SCAR=0.0
174  
175 17 ▶use AnyEvent ();
Subroutine BEGIN: called CC=1 SCAR=0.0
176 17 ▶use AnyEvent::MCP ();
Subroutine BEGIN: called CC=1 SCAR=0.0
177 17 ▶use AnyEvent::MCP::Helper ();
Subroutine BEGIN: called CC=1 SCAR=0.0
178  
179 17 ▶use AnyEvent::MCP::Server::Simple;
Subroutine BEGIN: called CC=1 SCAR=0.0
180  
181 17 my $options = mcp_getoptions ({
182 usage => "Usage: $0 [OPTION]...\n",
183 description => "Ask a human question or display an MCP form, locally or through native elicitation.",
184 options => [["--ask MODE", "Ask via helper (default), tty, yad, mcp, or auto"]],
185 examples => " $0 --stdio\n $0 --ask mcp --name questions --print-url",
186 }, "ask=s" => \my $ask_mode);
187 $ask_mode //= $ENV{PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL} eq "stdio"
188 16 ▶ ? "mcp" : $ENV{PERL_ANYEVENT_MCP_PERMISSION_ASK} || "helper";
Branch: 1 branch
BranchTrueFalseTotal
$ENV{'PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL'} eq 'stdio' ? : 7 1 8
Condition75%3/4
$ask_mode //= $ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio" ? "mcp" : $ENV{"PERL_ANYEVENT_MCP_PERMISSION_ASK"} || "helper"
l!l
88
$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
189 16 ▶$ask_mode =~ /\A(?:helper|tty|yad|auto|mcp)\z/ or die "--ask must be helper, tty, yad, auto, or mcp\n";
Branch: 1 branch
BranchTrueFalseTotal
$ask_mode =~ /\A(?:helper|tty|yad|auto|mcp)\z/u or die "--ask must be helper, tty, yad, auto, or mcp\n" 16 0 16
190  
191 16 my %pending;
192  
193 58 ▶sub _call {
Subroutine _call: called CC=1 SCAR=0.0
194 58 my ($req) = @_;
195  
196 58 my %params = %{$req->{params}};
197 58 delete @params{qw(inputResponses requestState _meta)};
198 # _meta is per-request context, not stable operation identity: retries can
199 # carry different client capabilities, progress tokens and clientInfo.
200 # bind the one-use token to the protocol version and semantic parameters.
201 58 JSON::XS->new->canonical->encode ([$req->{protocol_version}, $req->{method}, \%params])
202 }
203  
204 26 ▶sub answer_question {
Subroutine answer_question: called CC=14 SCAR=27.5
205 26 my ($req, $id, $labels, $response) = @_;
206  
207 26 ▶ ref $response eq "HASH"
Branch: 1 branch
BranchTrueFalseTotal
ref $response eq "HASH" or return $req->error("Invalid question response") 26 0 26
208 or return $req->error ("Invalid question response");
209  
210 26 my $action = $response->{action};
211 26 ▶ return $req->result ({ id => $id, status => "declined" }) if $action eq "decline";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "decline" 3 23 26
212 23 ▶ return $req->result ({ id => $id, status => "cancelled" }) if $action eq "cancel";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "cancel" 2 21 23
213 21 ▶ $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") 21 0 21
Condition33%1/3
$action eq "accept" and ref $response->{"content"} eq "HASH"
!ll&&!rl&&r
0021
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
214 or return $req->error ("Invalid question response action");
215  
216 21 my $content = $response->{content};
217 21 my $text = $content->{free_text};
218 21 my $choice = $content->{choice};
219 21 ▶ return $req->error ("Invalid free-text answer")
Branch: 1 branch
BranchTrueFalseTotal
if defined $text and ref $text || length $text > 4096 0 21 21
Condition50%3/6
defined $text and ref $text || length $text > 4096
!ll&&!rl&&r
1920
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
220 if defined $text && (ref $text || length $text > 4096);
221 return $req->error ("Invalid selected answer")
222 21 ▶ if defined $choice && (ref $choice || !$labels->{$choice});
Branch: 1 branch
BranchTrueFalseTotal
if defined $choice and ref $choice || !$labels->{$choice} 1 20 21
Condition83%5/6
defined $choice and ref $choice || !$labels->{$choice}
!ll&&!rl&&r
2181
ref $choice or not $labels->{$choice}
l!l&&r!l&&!r
0118
MC/DC66%2/3
defined $choice and ref $choice || !$labels->{$choice}
defined $choice ref $choice not $labels->{$choice}
Truth table75%3/4
A and B or not(C)
A= defined $choiceB= ref $choiceC= not $labels->{$choice}
ABCresult
0XX0
1000
11X1
1011
223  
224 20 ▶ my $source = $text =~ /\S/ ? "free_text"
Branch: 2 branches
BranchTrueFalseTotal
$text =~ /\S/u ? : 2 18 20
defined $choice ? : 17 1 18
225 : defined $choice ? "choice"
226 : return $req->error ("No answer supplied");
227  
228 return $req->result ({
229 id => $id,
230 status => "answered",
231 19 answer => $content->{$source},
232 source => $source,
233 });
234 }
235  
236 79 ▶sub elicit_form {
Subroutine elicit_form: called CC=18 SCAR=29.7
237 79 my ($req, $form, $key, $done) = @_;
238  
239 79 my $state = $req->{params}{requestState};
240 79 ▶ if (defined $state || exists $req->{params}{inputResponses}) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $state or exists $req->{"params"}{"inputResponses"}) 33 46 79
Condition66%2/3
defined $state or exists $req->{"params"}{"inputResponses"}
l!l&&r!l&&!r
33046
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
241 33 ▶ my $entry = delete $pending{$state}
Branch: 1 branch
BranchTrueFalseTotal
if defined $state and not ref $state 33 0 33
Condition33%1/3
defined $state and not ref $state
!ll&&!rl&&r
0033
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
242 if defined $state && !ref $state;
243 33 ▶ $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") 26 7 33
Condition100%3/3
$entry and $entry->{"call"} eq _call($req)
!ll&&!rl&&r
4326
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
244 or return $req->error ("Invalid or expired $key continuation");
245  
246 26 return $done->($req, $req->{params}{inputResponses}{$key});
247 }
248  
249 46 my $caps = $req->{params}{_meta}{"io.modelcontextprotocol/clientCapabilities"};
250 my $native = $req->{protocol_version} ge "2026"
251 && ref $caps eq "HASH" && ref $caps->{elicitation} eq "HASH"
252 46 ▶ && (!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
16129
$req->{"protocol_version"} ge 2026 and ref $caps eq "HASH" and ref $caps->{"elicitation"} eq "HASH"
!ll&&!rl&&r
10630
$req->{"protocol_version"} ge 2026 and ref $caps eq "HASH"
!ll&&!rl&&r
10036
not keys %{$$caps{"elicitation"};} or ref $caps->{"elicitation"}{"form"} eq "HASH"
l!l&&r!l&&!r
4251
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
253  
254 46 ▶ 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) 11 35 46
Condition100%6/6
$ask_mode =~ /\A(?:helper|tty|yad)\z/u or $ask_mode eq "auto" and not $native
l!l&&r!l&&!r
10135
$ask_mode eq "auto" and not $native
!ll&&!rl&&r
3411
MC/DC100%3/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 table100%4/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
255 my $job = AnyEvent::MCP::Helper->new (
256 helper => $ask_mode eq "tty" || $ask_mode eq "yad"
257 ? ["anyevent-mcp-form-elicitation", "--$ask_mode"]
258 11 ▶ : $ENV{PERL_ANYEVENT_MCP_ELICITATION_HELPER} || "anyevent-mcp-form-elicitation",
Branch: 1 branch
BranchTrueFalseTotal
$ask_mode eq 'tty' || $ask_mode eq 'yad' ? : 2 9 11
Condition80%4/5
$ask_mode eq "tty" or $ask_mode eq "yad"
l!l&&r!l&&!r
119
$ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"} or "anyevent-mcp-form-elicitation"
l!l
90
MC/DC100%2/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 table100%3/3
A or B
A= $ask_mode eq "tty"B= $ask_mode eq "yad"
ABresult
1X1
011
000
Truth table50%1/2
A
A= $ENV{"PERL_ANYEVENT_MCP_ELICITATION_HELPER"}
Aresult
11
00
259 timeout => 1800,
260 );
261 11 my $old_cancel = $req->{on_cancel};
262 0 ▶ $req->{on_cancel} = sub { $job->cancel; $old_cancel->(@_) if $old_cancel };
Subroutine __ANON__: not called CC=2 SCAR=14.0
Branch: 1 branch
BranchTrueFalseTotal
if $old_cancel 0 0 0
263 11 ▶ $job->ask ($form, sub {
Subroutine __ANON__: called CC=3 SCAR=11.4
264 11 my ($success, $response) = @_;
265  
266 11 ▶ return if $req->{finished};
Branch: 1 branch
BranchTrueFalseTotal
if $req->{"finished"} 0 11 11
267 11 ▶ return $req->error ($response) unless $success;
Branch: 1 branch
BranchTrueFalseTotal
unless $success 0 11 11
268 11 $done->($req, $response);
269 11 });
270 11 return;
271 }
272 35 ▶ $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") 29 6 35
273  
274 29 my $token = "ae-mcp-$key:" . unpack "H*", AnyEvent::MCP::random_bytes 32;
275 29 my $entry = $pending{$token} = { call => _call ($req) };
276 0 ▶ $entry->{timer} = AnyEvent->timer (after => 1800, cb => sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
277 0 delete $pending{$token};
278 29 });
279  
280 29 $req->reply ({
281 resultType => "input_required",
282 requestState => $token,
283 inputRequests => {
284 $key => {
285 method => "elicitation/create",
286 params => $form,
287 },
288 },
289 });
290 }
291  
292 55 ▶sub ask_user {
Subroutine ask_user: called CC=30 SCAR=42.2
293 55 my ($req, $args) = @_;
294  
295 55 ▶ my $id = $args->{id} // "question";
Condition100%2/2
$args->{"id"} // "question"
l!l
3124
MC/DC100%1/1
$args->{"id"} // "question"
$args->{"id"}
Truth table100%2/2
A
A= $args->{"id"}
Aresult
11
00
296 55 my $question = $args->{question};
297 55 ▶ my $options = $args->{options} // [];
Condition100%2/2
$args->{"options"} // []
l!l
532
MC/DC100%1/1
$args->{"options"} // []
$args->{"options"}
Truth table100%2/2
A
A= $args->{"options"}
Aresult
11
00
298  
299 55 ▶ !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") 55 0 55
Condition33%1/3
not ref $id and $id =~ /\A[A-Za-z_][A-Za-z_0-9-]{0,63}\z/u
!ll&&!rl&&r
0055
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
300 or return $req->error ("Invalid question id");
301 55 ▶ 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") 55 0 55
Condition33%3/9
defined $question and not ref $question and $question =~ /\S/u and length $question <= 4096
!ll&&!rl&&r
0055
defined $question and not ref $question and $question =~ /\S/u
!ll&&!rl&&r
0055
defined $question and not ref $question
!ll&&!rl&&r
0055
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
302 or return $req->error ("Question must be a nonempty string");
303 return $req->error ("Invalid question header")
304 55 ▶ 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 55 55
Condition50%3/6
defined $args->{"header"} and ref $args->{"header"} || length $args->{"header"} > 64
!ll&&!rl&&r
26290
ref $args->{"header"} or length $args->{"header"} > 64
l!l&&r!l&&!r
0029
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
305 55 ▶ ref $options eq "ARRAY" && @$options <= 3
Branch: 1 branch
BranchTrueFalseTotal
ref $options eq "ARRAY" and @$options <= 3 or return $req->error("Invalid answer options") 55 0 55
Condition33%1/3
ref $options eq "ARRAY" and @$options <= 3
!ll&&!rl&&r
0055
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
306 or return $req->error ("Invalid answer options");
307  
308 55 my %labels;
309 55 for my $option (@$options) {
310 ref $option eq "HASH" && defined $option->{label}
311 && !ref $option->{label} && $option->{label} =~ /\S/
312 && length $option->{label} <= 100
313 && (!defined $option->{description}
314 || !ref $option->{description} && length $option->{description} <= 512)
315 106 ▶ && !$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") 105 1 106
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
01105
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
00106
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
00106
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"} and $option->{"label"} =~ /\S/u
!ll&&!rl&&r
00106
ref $option eq "HASH" and defined $option->{"label"} and not ref $option->{"label"}
!ll&&!rl&&r
00106
ref $option eq "HASH" and defined $option->{"label"}
!ll&&!rl&&r
00106
not defined $option->{"description"} or not ref $option->{"description"} and length $option->{"description"} <= 512
l!l&&r!l&&!r
48580
not ref $option->{"description"} and length $option->{"description"} <= 512
!ll&&!rl&&r
0058
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
316 or return $req->error ("Invalid answer option");
317 }
318  
319 my $schema = {
320 type => "object",
321 properties => {
322 (@$options ? (choice => {
323 type => "string",
324 title => "Select an answer (or use free text)",
325 54 ▶ enum => [map $_->{label}, @$options],
Branch: 3 branches
BranchTrueFalseTotal
@$options ? : 52 2 54
@$options ? : 52 2 54
@$options ? : 52 2 54
326 }) : ()),
327 free_text => {
328 type => "string",
329 title => @$options ? "Alternative answer (optional)" : "Your answer",
330 maxLength => 4096,
331 },
332 },
333 (@$options ? () : (required => ["free_text"])),
334 };
335 my $message = join "\n",
336 (length $args->{header} ? $args->{header} : ()),
337 $question,
338 54 ▶ map { $_->{label} . (length $_->{description} ? " - $_->{description}" : "") } @$options;
Branch: 2 branches
BranchTrueFalseTotal
length $args->{'header'} ? : 29 25 54
length $_->{'description'} ? : 58 46 104
339  
340 54 my $form = { mode => "form", message => $message, requestedSchema => $schema };
341 AE::log debug => "ask-user ask-user $id"
342 54 ▶ unless defined $req->{params}{requestState};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $req->{"params"}{"requestState"} 31 23 54
343 26 ▶ elicit_form ($req, $form, question => sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
344 26 answer_question ($_[0], $id, \%labels, $_[1]);
345 54 });
346 }
347  
348 11 ▶sub answer_form {
Subroutine answer_form: called CC=8 SCAR=20.8
349 11 my ($req, $response) = @_;
350  
351 ref $response eq "HASH" && defined $response->{action} && !ref $response->{action}
352 11 ▶ 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") 10 1 11
Condition66%4/6
ref $response eq "HASH" and defined $response->{"action"} and not ref $response->{"action"}
!ll&&!rl&&r
1010
ref $response eq "HASH" and defined $response->{"action"}
!ll&&!rl&&r
0110
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
353  
354 10 my $action = $response->{action};
355 10 ▶ return $req->result ({ action => $action }) if $action eq "decline" || $action eq "cancel";
Branch: 1 branch
BranchTrueFalseTotal
if $action eq "decline" or $action eq "cancel" 4 6 10
Condition100%3/3
$action eq "decline" or $action eq "cancel"
l!l&&r!l&&!r
226
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
356 6 ▶ $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") 3 3 6
Condition100%3/3
$action eq "accept" and ref $response->{"content"} eq "HASH"
!ll&&!rl&&r
123
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
357 or return $req->error ("Invalid form response action");
358  
359 3 $req->result ({ action => $action, content => $response->{content} });
360 }
361  
362 27 ▶sub ask_form {
Subroutine ask_form: called CC=7 SCAR=19.7
363 27 my ($req, $args) = @_;
364  
365 defined $args->{message} && !ref $args->{message}
366 27 ▶ 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") 26 1 27
Condition66%2/3
defined $args->{"message"} and not ref $args->{"message"}
!ll&&!rl&&r
0126
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
367  
368 26 my $schema = $args->{requestedSchema};
369 26 ▶ 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") 25 1 26
Condition66%4/6
ref $schema eq "HASH" and $schema->{"type"} eq "object" and ref $schema->{"properties"} eq "HASH"
!ll&&!rl&&r
1025
ref $schema eq "HASH" and $schema->{"type"} eq "object"
!ll&&!rl&&r
0125
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
370 or return $req->error ("Form needs an object schema with properties");
371  
372 AE::log debug => "ask-user ask-form"
373 25 ▶ unless defined $req->{params}{requestState};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $req->{"params"}{"requestState"} 15 10 25
374 elicit_form ($req, {
375 mode => "form",
376 message => $args->{message},
377 25 requestedSchema => $schema,
378 }, form => \&answer_form);
379 }
380  
381 16 mcp_tool ask_user =>
382 "Ask human question; await answer or distinct decline/cancel status. Configured mode uses local helper or native MCP elicitation.",
383 {
384 type => "object",
385 required => ["question"],
386 properties => {
387 id => { type => "string", description => "Stable question ID (default: question)" },
388 header => { type => "string", description => "Optional short heading" },
389 question => { type => "string", description => "Question shown to human" },
390 options => {
391 type => "array",
392 maxItems => 3,
393 description => "Up to 3 suggested answers; free text always allowed.",
394 items => {
395 type => "object",
396 required => ["label"],
397 properties => {
398 label => { type => "string" },
399 description => { type => "string" },
400 },
401 },
402 },
403 },
404 },
405 \&ask_user;
406  
407 16 mcp_tool ask_form =>
408 "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.",
409 {
410 type => "object",
411 required => ["message", "requestedSchema"],
412 additionalProperties => JSON::XS::false,
413 properties => {
414 message => {
415 type => "string",
416 description => "Form purpose and explanation",
417 },
418 requestedSchema => {
419 type => "object",
420 description => "MCP form schema: object with named properties",
421 },
422 },
423 },
424 \&ask_form;
425  
426 16 mcp_config
427 server_name => "mcp-ask-user",
428 server_version => $AnyEvent::MCP::VERSION,
429 short_instructions => "Ask human when input needed: ask-user for question, ask-form for fields. Decline/cancel are not answers.",
430 instructions => "Use only when human input needed. ask-user: question, choices, free text. ask-form: MCP form schema. Decline/cancel are not answers.";
431  
432 16 mcp_start %$options;
« blib/lib/AnyEvent/MCP/Server/JSONL.pm ↑ Summary bin/mcp-http »