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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
local async = require('panto_mcp.async')
local json = require('panto').ext.json
local results = require('panto_mcp.results')
local M = {}
local function shell_words(text)
local words, i = {}, 1
while i <= #text do
while text:sub(i,i):match('%s') do i=i+1 end
if i > #text then break end
local out, quote, started = {}, nil, false
while i <= #text do
local ch=text:sub(i,i)
if quote == "'" then
if ch == "'" then quote=nil else out[#out+1]=ch end
started=true; i=i+1
elseif quote == '"' then
if ch == '"' then quote=nil; i=i+1
elseif ch == '\\' then
if i == #text then return nil,'trailing escape' end
out[#out+1]=text:sub(i+1,i+1); i=i+2
else out[#out+1]=ch; i=i+1 end
started=true
elseif ch:match('%s') then break
elseif ch == "'" or ch == '"' then quote=ch; started=true; i=i+1
elseif ch == '\\' then
if i == #text then return nil,'trailing escape' end
out[#out+1]=text:sub(i+1,i+1); started=true; i=i+2
else out[#out+1]=ch; started=true; i=i+1 end
end
if quote then return nil,'unclosed quote' end
if started then words[#words+1]=table.concat(out) end
end
return words
end
M.shell_words = shell_words
local function has_named_token(text,name)
local needle=name..'='
local cursor=1
while true do
local start=text:find(needle,cursor,true)
if not start then return false end
if start==1 or text:sub(start-1,start-1):match('%s') then return true end
cursor=start+1
end
end
function M.parse_arguments(prompt, text)
if type(text) ~= 'string' then return nil,'arguments must be text' end
local args, definitions = {}, {}
for _, argument in ipairs(prompt.arguments or {}) do
if type(argument.name) ~= 'string' or argument.name == '' then return nil,'invalid prompt argument metadata' end
definitions[argument.name]=argument
end
local words,err={},nil
if #(prompt.arguments or {})==1 then
local only=prompt.arguments[1].name
local remainder=text:match('^%s*(.-)%s*$') or ''
if not has_named_token(remainder,only) then
if remainder~='' then args[only]=remainder end
else words,err=shell_words(text) end
else words,err=shell_words(text) end
if not words then return nil,err end
for _,word in ipairs(words) do
local equals=word:find('=',1,true)
if not equals or equals == 1 then return nil,'expected name=value argument' end
local name,value=word:sub(1,equals-1),word:sub(equals+1)
if not definitions[name] then return nil,'unknown prompt argument: '..name end
if args[name] ~= nil then return nil,'duplicate prompt argument: '..name end
args[name]=value
end
local missing={}
for _,argument in ipairs(prompt.arguments or {}) do
if argument.required and args[argument.name] == nil then missing[#missing+1]=argument.name end
end
if #missing > 0 then return nil,'missing required arguments: '..table.concat(missing,', ') end
return args
end
local function text_block(text) return {type='text',text=text} end
local function content_blocks(content, role)
if type(content)=='string' then return {text_block(content)} end
local entries
if type(content)~='table' then return {text_block('[Unsupported MCP prompt content]')} end
if type(content.type)=='string' then entries={content} else entries=content end
local out={}
local function add_image(data,mime)
mime=type(mime)=='string' and mime or nil
local supported={['image/png']=true,['image/jpeg']=true,['image/webp']=true,['image/bmp']=true,['image/gif']=true}
local is_image=mime and supported[mime:lower()]
local decoded=is_image and type(data)=='string' and results.decode64(data)
if role=='assistant' then out[#out+1]=text_block('[Assistant media omitted: '..tostring(mime or 'image')..']')
elseif not is_image then out[#out+1]=text_block('[MCP unsupported attachment omitted: '..tostring(mime or 'unknown MIME type')..']')
elseif decoded then out[#out+1]={type='media',data=decoded,media_type=mime}
else out[#out+1]=text_block('[Invalid MCP image omitted]') end
end
for _,block in ipairs(entries) do
if type(block)~='table' then out[#out+1]=text_block('[Unsupported MCP prompt content]')
elseif block.type=='text' then out[#out+1]=text_block(block.text or '')
elseif block.type=='image' then add_image(block.data,block.mimeType)
elseif block.type=='audio' then out[#out+1]=text_block('[MCP audio omitted: '..tostring(block.mimeType or 'unknown MIME type')..']')
elseif block.type=='resource' and type(block.resource)=='table' then
local resource=block.resource
if type(resource.text)=='string' then out[#out+1]=text_block((type(resource.uri)=='string' and '['..resource.uri..']\n' or '')..resource.text)
elseif resource.blob then add_image(resource.blob,resource.mimeType)
else out[#out+1]=text_block('[MCP resource omitted: '..tostring(resource.uri or 'unknown URI')..']') end
else out[#out+1]=text_block('[Unsupported MCP prompt content: '..tostring(block.type or 'unknown')..']') end
end
return out
end
function M.map_messages(messages)
if type(messages)~='table' then return nil,'invalid prompt messages' end
local mapped={}
for _,message in ipairs(messages) do
if type(message)~='table' or (message.role~='user' and message.role~='assistant') then
return nil,'invalid prompt message role'
end
mapped[#mapped+1]={role=message.role,blocks=content_blocks(message.content,message.role)}
end
return mapped
end
local function preflight(mapped)
local has_media=false
for _,message in ipairs(mapped) do
for _,block in ipairs(message.blocks) do if block.type=='media' then has_media=true end end
end
if not has_media then return end
local probe=require('panto').conversation()
for _,message in ipairs(mapped) do
if message.role=='user' then probe:add_user_blocks(message.blocks)
else probe:add_assistant_message({blocks=message.blocks}) end
end
end
function M.append_to(agent, messages)
local mapped,err=M.map_messages(messages)
if not mapped then return nil,err end
local ok=pcall(preflight,mapped)
if not ok then return nil,'MCP prompt image could not be decoded' end
local trailing_user=mapped[#mapped] and mapped[#mapped].role=='user'
local conv=agent:conversation()
local stop=trailing_user and #mapped-1 or #mapped
for i=1,stop do
local message=mapped[i]
if message.role=='user' then conv:add_user_blocks(message.blocks)
else conv:add_assistant_message({blocks=message.blocks}) end
end
if trailing_user then agent:submit(mapped[#mapped].blocks); return true end
return false
end
local function log(err) io.stderr:write('panto-mcp: prompt command: ',tostring(err),'\n') end
local function unregister(ext,name)
local ok,value,err=pcall(ext.unregister_command,name)
if not ok or not value then log(ok and (err or ('cannot unregister '..name)) or value); return false end
return true
end
local function prompt_description(prompt)
local parts={}
if type(prompt.title)=='string' and prompt.title~='' then parts[#parts+1]=prompt.title end
if type(prompt.description)=='string' and prompt.description~='' then parts[#parts+1]=prompt.description end
local names={}
for _,argument in ipairs(prompt.arguments or {}) do names[#names+1]=argument.name end
if #names>0 then parts[#parts+1]='Arguments: '..table.concat(names,', ') end
return #parts>0 and table.concat(parts,' — ') or ('MCP prompt '..prompt.name)
end
function M.commands(ext, manager, turn, dynamic, warnings)
local registered, warned={},{}
local error_mount,error_text
local function clear_error()
if error_mount then
pcall(function() if error_mount:alive() then error_mount:unmount() end end)
error_mount=nil; error_text=nil
end
end
local function show_error(err)
error_text='MCP prompt failed: '..tostring(err):gsub('[%z\1-\8\11\12\14-\31\127]','?'):sub(1,800)
if error_mount then
local ok=pcall(error_mount.invalidate,error_mount)
if ok then return end
error_mount=nil
end
if type(ext.mount)=='function' then
local ok,handle=pcall(ext.mount,{render=function() return error_text end},'above_input')
if ok then error_mount=handle; return end
end
log(error_text)
end
if type(ext.on)=='function' then
ext.on('command_start',clear_error); ext.on('turn_start',clear_error)
end
local function warning(key,text)
if warned[key] then return end
warned[key]=true
local message='prompt '..text
if warnings then warnings[#warnings+1]=message end
log(message)
end
local function reconcile(server, metadata, warm)
local wanted={}
for _,prompt in ipairs((metadata and metadata.catalog and metadata.catalog.prompts) or {}) do
if type(prompt.name)=='string' and not prompt.name:find('[/%s]') then
local name='mcp:'..server..':'..prompt.name
local description=prompt_description(prompt)
wanted[name]={server=server,prompt=prompt,signature=json.encode({description=description,arguments=prompt.arguments})}
else warning(server..':'..tostring(prompt.name),'command skipped because its name contains slash or whitespace: '..tostring(prompt.name)) end
end
if dynamic then
for name,old in pairs(registered) do
if old.server==server then
local next_prompt=wanted[name]
if not next_prompt or next_prompt.signature~=old.signature then
if unregister(ext,name) then registered[name]=nil end
end
end
end
end
for name,current in pairs(wanted) do
if not registered[name] and (dynamic or warm) then
local handler=function(text)
if turn.busy then return 'Cannot run an MCP prompt while a turn is in progress.' end
local args,why=M.parse_arguments(current.prompt,text or '')
if not args then return 'MCP prompt arguments: '..why end
async.run(function()
local messages,err=manager:prompt(current.server,current.prompt.name,args)
if not messages then show_error(err); return end
if turn.busy then show_error('result discarded because a turn started while the prompt was loading'); return end
local submitted,append_err=M.append_to(require('panto').ext.agent,messages)
if submitted==nil then show_error(append_err)
elseif not submitted and type(ext.emit)=='function' then
local emitted,emit_err=pcall(ext.emit,'agent_submission')
if not emitted then show_error(emit_err) end
end
end,show_error)
return 'Fetching MCP prompt…'
end
local ok,value,err=pcall(ext.register_command,{name=name,description=prompt_description(current.prompt),handler=handler})
if ok and (value or (not dynamic and err==nil)) then registered[name]=current
else
local reason=ok and (err or ('register_command failed for '..name)) or value
warning(name..':registration','command registration failed for '..name..': '..tostring(reason))
end
end
end
end
return {reconcile=reconcile,registered=registered}
end
function M.track_busy(ext,turn,prompt_commands)
local in_turn,commands,prompt_dispatch=false,0,false
local function update() turn.busy=in_turn or commands>0 end
local function event_name(event)
return type(event)=='table' and type(event.command_name)=='string' and event.command_name or '<unknown command>'
end
ext.on('turn_start',function() in_turn=true; update() end)
ext.on('turn_end',function() in_turn=false; update() end)
ext.on('command_start',function(event)
local name=event_name(event)
prompt_dispatch=prompt_commands.registered[name]~=nil
if not prompt_dispatch then commands=commands+1 end
update()
end)
ext.on('command_end',function(event)
if not prompt_dispatch then commands=math.max(0,commands-1) end
prompt_dispatch=false
update()
end)
end
return M
|