@powerfm/libretime-mcp 0.2.0 → 0.5.0

package/README.md

@@ -12,8 +12,11 @@ Tools are organised into subdirectories under `src/tools/` — one file per tool
 
 **Read-only (client & admin)**
 - `get_shows` — list all shows
+- `get_show` — get a single show by ID
+- `get_show_instances` — list scheduled show slots (filterable by show, date range)
 - `get_schedule` — broadcast schedule
 - `get_stream_state` — current on-air state
+- `get_station_info` — station name, timezone, and configuration
 
 **Analytics (admin)**
 - ~~`get_listener_counts`~~ — disabled (API returns full history with no filtering, ~120k records)
@@ -21,13 +24,32 @@ Tools are organised into subdirectories under `src/tools/` — one file per tool
 
 **Media library (admin)**
 - `search_files` — search your media library
-- `upload_file` — upload an audio file _(stdio only — reads from local filesystem)_
+- `upload_file` — upload an audio file via drag-and-drop UI (works in both stdio and HTTP modes — see [File Upload](#file-upload))
 - `update_file_metadata` — edit track metadata
 - `delete_file` — remove a file
 
+**Shows & scheduling (admin)**
+- `create_show` — create a new show
+- `schedule_file` — schedule an uploaded file into a show instance
+
+**Playlists (admin)**
+- `get_playlists` — list all playlists
+- `create_playlist` — create a new playlist
+- `get_playlist_contents` — list items in a playlist
+- `add_to_playlist` — add a file or stream to a playlist
+
 **Users (admin)**
-- `get_users` — list station users
-- `get_hosts` — list show hosts
+- `get_users` — list station users (pass `include_email: true` to include email addresses, omitted by default)
+- `get_hosts` — list show hosts with their show assignments
+
+## File Upload
+
+`upload_file` renders a drag-and-drop UI in the Claude chat window. It works the same way in both transport modes:
+
+- **HTTP mode** — the UI posts directly to the MCP server's `/upload` endpoint
+- **stdio mode** — the admin server spins up a lightweight sidecar HTTP server (default port `4000`) that the UI posts to. The MCP protocol itself continues over stdio; the upload is a side-channel.
+
+Both modes use the same upload token generated at startup, so there's no separate configuration needed. To change the sidecar port in stdio mode set `UPLOAD_PORT` in your environment.
 
 ## Option 1 — Claude Desktop (stdio)
 
@@ -50,13 +72,16 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
       "env": {
         "LIBRETIME_URL": "https://your-instance.example.com",
         "LIBRETIME_USER": "user",
-        "LIBRETIME_PASS": "pass"
+        "LIBRETIME_PASS": "pass",
+        "LIBRETIME_API_KEY": "your_libretime_api_key"
       }
     }
   }
 }
 ```
 
+`LIBRETIME_API_KEY` is the `general.api_key` value from your LibreTime `config.yml`. It is required for file uploads — omit it if you are using the read-only client.
+
 Use `libretime-mcp-client` instead of `libretime-mcp` for read-only access.
 
 ### npx (no install)
@@ -156,8 +181,16 @@ npm run build
 
 # Tests
 npm test
+
+# MCP Inspector — browse and call tools interactively
+npm run inspect:admin           # stdio admin server
+npm run inspect:client          # stdio read-only server
+npm run inspect:admin-http      # HTTP admin (start the server first, then run this)
+npm run inspect:client-http     # HTTP read-only (start the server first, then run this)
 ```
 
+The inspector opens a browser UI at `http://localhost:5173` where you can list tools, see their schemas, and call them with custom inputs.
+
 ## Servers
 
 | Command | Transport | Port | Access |

package/dist/apps/upload-file.html

@@ -84,7 +84,7 @@ Boolean requesting whether a visible border and background is provided by the ho
 - omitted: host decides border`)}),L({method:B(`ui/request-display-mode`),params:L({mode:oc.describe(`The display mode being requested.`)})});var Sc=L({mode:oc.describe(`The display mode that was actually set. May differ from requested if not supported.`)}).passthrough(),Cc=R([B(`model`),B(`app`)]).describe(`Tool visibility scope - who can access the tool.`);L({resourceUri:j().optional(),visibility:I(Cc).optional().describe(`Who can access this tool. Default: ["model", "app"]
 - "model": Tool visible to and callable by the agent
 - "app": Tool callable by the app from this server only`)}),L({mimeTypes:I(j()).optional().describe('Array of supported MIME types for UI resources.\nMust include `"text/html;profile=mcp-app"` for MCP Apps support.')}),L({method:B(`ui/download-file`),params:L({contents:I(R([ns,rs])).describe(`Resource contents to download — embedded (inline data) or linked (host fetches). Uses standard MCP resource types.`)})}),L({method:B(`ui/message`),params:L({role:B(`user`).describe(`Message role, currently only "user" is supported.`),content:I(is).describe(`Message content blocks (text, image, etc.).`)})}),L({method:B(`ui/notifications/sandbox-resource-ready`),params:L({html:j().describe(`HTML content to load into the inner iframe.`),sandbox:j().optional().describe(`Optional override for the inner iframe's sandbox attribute.`),csp:dc.optional().describe(`CSP configuration from resource metadata.`),permissions:fc.optional().describe(`Sandbox permissions from resource metadata.`)})});var wc=L({method:B(`ui/notifications/tool-result`),params:ps.describe(`Standard MCP tool execution result.`)}),Tc=L({toolInfo:L({id:Pa.optional().describe(`JSON-RPC id of the tools/call request.`),tool:us.describe(`Tool definition including name, inputSchema, etc.`)}).optional().describe(`Metadata of the tool call that instantiated this App.`),theme:ac.optional().describe(`Current color theme preference.`),styles:_c.optional().describe(`Style configuration for theming the app.`),displayMode:oc.optional().describe(`How the UI is currently displayed.`),availableDisplayModes:I(oc).optional().describe(`Display modes the host supports.`),containerDimensions:R([L({height:M().describe(`Fixed container height in pixels.`)}),L({maxHeight:R([M(),Pi()]).optional().describe(`Maximum container height in pixels.`)})]).and(R([L({width:M().describe(`Fixed container width in pixels.`)}),L({maxWidth:R([M(),Pi()]).optional().describe(`Maximum container width in pixels.`)})])).optional().describe(`Container dimensions. Represents the dimensions of the iframe or other
-container holding the app. Specify either width or maxWidth, and either height or maxHeight.`),locale:j().optional().describe(`User's language and region preference in BCP 47 format.`),timeZone:j().optional().describe(`User's timezone in IANA format.`),userAgent:j().optional().describe(`Host application identifier.`),platform:R([B(`web`),B(`desktop`),B(`mobile`)]).optional().describe(`Platform type for responsive design decisions.`),deviceCapabilities:L({touch:N().optional().describe(`Whether the device supports touch input.`),hover:N().optional().describe(`Whether the device supports hover interactions.`)}).optional().describe(`Device input capabilities.`),safeAreaInsets:L({top:M().describe(`Top safe area inset in pixels.`),right:M().describe(`Right safe area inset in pixels.`),bottom:M().describe(`Bottom safe area inset in pixels.`),left:M().describe(`Left safe area inset in pixels.`)}).optional().describe(`Mobile safe area boundaries in pixels.`)}).passthrough(),Ec=L({method:B(`ui/notifications/host-context-changed`),params:Tc.describe(`Partial context update containing only changed fields.`)});L({method:B(`ui/update-model-context`),params:L({content:I(is).optional().describe(`Context content blocks (text, image, etc.).`),structuredContent:z(j(),P().describe(`Structured content for machine-readable context data.`)).optional().describe(`Structured content for machine-readable context data.`)})}),L({method:B(`ui/initialize`),params:L({appInfo:Ya.describe(`App identification (name and version).`),appCapabilities:xc.describe(`Features and capabilities this app provides.`),protocolVersion:j().describe(`Protocol version this app supports.`)})});var Dc=L({protocolVersion:j().describe(`Negotiated protocol version string (e.g., "2025-11-21").`),hostInfo:Ya.describe(`Host application identification and version.`),hostCapabilities:bc.describe(`Features and capabilities provided by the host.`),hostContext:Tc.describe(`Rich context about the host environment.`)}).passthrough(),Oc=class extends nc{_appInfo;_capabilities;options;_hostCapabilities;_hostInfo;_hostContext;constructor(e,t={},n={autoResize:!0}){super(n),this._appInfo=e,this._capabilities=t,this.options=n,this.setRequestHandler(ao,e=>(console.log(`Received ping:`,e.params),{})),this.onhostcontextchanged=()=>{}}getHostCapabilities(){return this._hostCapabilities}getHostVersion(){return this._hostInfo}getHostContext(){return this._hostContext}set ontoolinput(e){this.setNotificationHandler(pc,t=>e(t.params))}set ontoolinputpartial(e){this.setNotificationHandler(mc,t=>e(t.params))}set ontoolresult(e){this.setNotificationHandler(wc,t=>e(t.params))}set ontoolcancelled(e){this.setNotificationHandler(hc,t=>e(t.params))}set onhostcontextchanged(e){this.setNotificationHandler(Ec,t=>{this._hostContext={...this._hostContext,...t.params},e(t.params)})}set onteardown(e){this.setRequestHandler(vc,(t,n)=>e(t.params,n))}set oncalltool(e){this.setRequestHandler(hs,(t,n)=>e(t.params,n))}set onlisttools(e){this.setRequestHandler(ds,(t,n)=>e(t.params,n))}assertCapabilityForMethod(e){}assertRequestHandlerCapability(e){switch(e){case`tools/call`:case`tools/list`:if(!this._capabilities.tools)throw Error(`Client does not support tool capability (required for ${e})`);return;case`ping`:case`ui/resource-teardown`:return;default:throw Error(`No handler for method ${e} registered`)}}assertNotificationCapability(e){}assertTaskCapability(e){throw Error(`Tasks are not supported in MCP Apps`)}assertTaskHandlerCapability(e){throw Error(`Task handlers are not supported in MCP Apps`)}async callServerTool(e,t){if(typeof e==`string`)throw Error(`callServerTool() expects an object as its first argument, but received a string ("${e}"). Did you mean: callServerTool({ name: "${e}", arguments: { ... } })?`);return await this.request({method:`tools/call`,params:e},ps,t)}async readServerResource(e,t){return await this.request({method:`resources/read`,params:e},Ro,t)}async listServerResources(e,t){return await this.request({method:`resources/list`,params:e},Mo,t)}sendMessage(e,t){return this.request({method:`ui/message`,params:e},uc,t)}sendLog(e){return this.notification({method:`notifications/message`,params:e})}updateModelContext(e,t){return this.request({method:`ui/update-model-context`,params:e},Wa,t)}openLink(e,t){return this.request({method:`ui/open-link`,params:e},cc,t)}sendOpenLink=this.openLink;downloadFile(e,t){return this.request({method:`ui/download-file`,params:e},lc,t)}requestTeardown(e={}){return this.notification({method:`ui/notifications/request-teardown`,params:e})}requestDisplayMode(e,t){return this.request({method:`ui/request-display-mode`,params:e},Sc,t)}sendSizeChanged(e){return this.notification({method:`ui/notifications/size-changed`,params:e})}setupSizeChangedNotifications(){let e=!1,t=0,n=0,r=()=>{e||(e=!0,requestAnimationFrame(()=>{e=!1;let r=document.documentElement,i=r.style.height;r.style.height=`max-content`;let a=Math.ceil(r.getBoundingClientRect().height);r.style.height=i;let o=Math.ceil(window.innerWidth);(o!==t||a!==n)&&(t=o,n=a,this.sendSizeChanged({width:o,height:a}))}))};r();let i=new ResizeObserver(r);return i.observe(document.documentElement),i.observe(document.body),()=>i.disconnect()}async connect(e=new ic(window.parent,window.parent),t){if(this.transport)throw Error(`App is already connected. Call close() before connecting again.`);await super.connect(e);try{let e=await this.request({method:`ui/initialize`,params:{appCapabilities:this._capabilities,appInfo:this._appInfo,protocolVersion:rc}},Dc,t);if(e===void 0)throw Error(`Server sent invalid initialize result: ${e}`);this._hostCapabilities=e.hostCapabilities,this._hostInfo=e.hostInfo,this._hostContext=e.hostContext,await this.notification({method:`ui/notifications/initialized`}),this.options?.autoResize&&this.setupSizeChangedNotifications()}catch(e){throw this.close(),e}}};function kc({appInfo:e,capabilities:t,onAppCreated:n}){let[r,i]=(0,l.useState)(null),[a,o]=(0,l.useState)(!1),[s,c]=(0,l.useState)(null);return(0,l.useEffect)(()=>{let r=!0;async function a(){try{let a=new ic(window.parent,window.parent),s=new Oc(e,t);n?.(s),await s.connect(a),r&&(i(s),o(!0),c(null))}catch(e){r&&(i(null),o(!1),c(e instanceof Error?e:Error(`Failed to connect`)))}}return a(),()=>{r=!1}},[]),{app:r,isConnected:a,error:s}}function Ac(){let[e,t]=(0,l.useState)(`loading`),[n,r]=(0,l.useState)(`idle`),[i,a]=(0,l.useState)(null),[o,s]=(0,l.useState)(``),[c,u]=(0,l.useState)(null),[d,f]=(0,l.useState)(null),[p,m]=(0,l.useState)(null),h=(0,l.useRef)(null),[g,_]=(0,l.useState)(``),[v,y]=(0,l.useState)([]),[b,x]=(0,l.useState)(null),[S,ee]=(0,l.useState)({track_title:``,artist_name:``,album_title:``,genre:``}),{app:C,error:te}=kc({appInfo:{name:`LibreTime File Uploader`,version:`1.0.0`},capabilities:{},onAppCreated:e=>{e.ontoolinput=async e=>{let t=e.arguments;t&&ee(e=>({track_title:t.track_title??e.track_title,artist_name:t.artist_name??e.artist_name,album_title:t.album_title??e.album_title,genre:t.genre??e.genre}))},e.ontoolresult=async e=>{let n=e.content?.find(e=>e.type===`text`)?.text;if(n)try{let e=JSON.parse(n);if(e.status===`success`&&e.file){a(e.file),r(`success`);return}u(e.upload_url??null),f(e.upload_token??null),y(e.libraries??[]),t(e.upload_url?`file-picker`:`url-input`)}catch{}},e.onteardown=async()=>({}),e.onerror=console.error}}),ne=(0,l.useCallback)(e=>{let t=e.target.files?.[0]??null;if(m(t),t&&!S.track_title){let e=t.name.replace(/\.[^.]+$/,``);ee(t=>({...t,track_title:t.track_title||e}))}},[S.track_title]),re=(0,l.useCallback)(e=>t=>{ee(n=>({...n,[e]:t.target.value}))},[]),ie=(0,l.useCallback)(async()=>{if(!(!p||!c||!d)){r(`uploading`);try{let e=new FormData;e.append(`file`,p,p.name),e.append(`name`,p.name),e.append(`mime`,p.type||`audio/mpeg`),e.append(`size`,String(p.size)),e.append(`accessed`,String(Math.floor(Date.now()/1e3)));for(let[t,n]of Object.entries(S))n.trim()&&e.append(t,n.trim());b!==null&&e.append(`library`,String(b));let t=await fetch(c,{method:`POST`,headers:{"X-Upload-Token":d},body:e});if(!t.ok){let e=await t.json().catch(()=>({error:t.statusText})),n=e.detail;s(`${e.error??`Upload failed`}${n?`: ${n}`:``}`),r(`error`);return}let n=await t.json();a(n),r(`success`),await C?.updateModelContext({content:[{type:`text`,text:`File uploaded: "${n.track_title??n.name}" (ID: ${n.id})`}]})}catch(e){s(e instanceof Error?e.message:String(e)),r(`error`)}}},[p,c,d,S,b,C]),ae=(0,l.useCallback)(async()=>{if(!(!g.trim()||!C)){r(`uploading`);try{let e={url:g.trim()};for(let[t,n]of Object.entries(S))n.trim()&&(e[t]=n.trim());b!==null&&(e.library=b);let t=(await C.callServerTool({name:`upload_file`,arguments:e})).content?.find(e=>e.type===`text`)?.text??``,n=JSON.parse(t);n.status===`success`&&n.file?(a(n.file),r(`success`),await C.updateModelContext({content:[{type:`text`,text:`File uploaded: "${n.file.track_title??n.file.name}" (ID: ${n.file.id})`}]})):(s(n.reason??`Upload failed`),r(`error`))}catch(e){s(e instanceof Error?e.message:String(e)),r(`error`)}}},[g,C,S,b]),oe=(0,l.useCallback)(()=>{m(null),_(``),r(`idle`),s(``),a(null),h.current&&(h.current.value=``)},[]);return{mode:e,uploadState:n,uploadedFile:i,errorMsg:o,file:p,url:g,libraries:v,selectedLibrary:b,metadata:S,busy:n===`uploading`,app:C,error:te,fileInputRef:h,handleFileChange:ne,handleMetadataChange:re,handleFilePick:ie,handleUrl:ae,handleReset:oe,setUrl:_,setSelectedLibrary:x}}var jc=`data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20xml:space='preserve'%20viewBox='0%200%2064%2064'%20clip-rule='evenodd'%20fill-rule='evenodd'%20image-rendering='optimizeQuality'%20shape-rendering='geometricPrecision'%20text-rendering='geometricPrecision'%3e%3cpath%20fill='%23474443'%20d='M31.993%2018.107c3.32%200%206.36%201.198%208.706%203.179l-3.438%203.444a8.687%208.687%200%200%200-10.522%200l-3.438-3.444a13.443%2013.443%200%200%201%208.692-3.179zm2.08%2026.966L35.711%2059h-7.437l1.653-13.927a13.44%2013.44%200%200%201-6.626-3.016l3.438-3.444a8.72%208.72%200%200%200%204.412%201.73v-1.73h-.84c-1.034%200-1.875-.858-1.875-1.893v-8.072c0-1.035.841-1.892%201.874-1.892h3.38c1.033%200%201.874.857%201.874%201.892v8.072c0%201.035-.841%201.893-1.874%201.893h-.841v1.73a8.72%208.72%200%200%200%204.412-1.73l3.438%203.444a13.44%2013.44%200%200%201-6.626%203.016zm.118-17.312c.399%200%20.723.31.723.71a.724.724%200%200%201-.723.724.722.722%200%200%201-.708-.724c0-.4.325-.71.708-.71zm-1.859.222c.28%200%20.502.222.502.488%200%20.28-.222.488-.502.488a.482.482%200%200%201-.487-.488c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.192.414.414a.413.413%200%200%201-.413.414.404.404%200%200%201-.414-.414c0-.222.177-.414.414-.414zm-1.387.103c.178%200%20.31.133.31.31a.303.303%200%200%201-.31.311.303.303%200%200%201-.31-.31c0-.178.133-.31.31-.31zm4.796%201.7c.399%200%20.723.326.723.725%200%20.384-.324.71-.723.71a.719.719%200%200%201-.708-.71c0-.4.325-.725.708-.725zm-1.859.222a.496.496%200%201%201%20.014.991.495.495%200%200%201-.014-.99zm-1.55.089c.222%200%20.414.177.414.414a.423.423%200%200%201-.413.414.413.413%200%200%201-.414-.414c0-.237.177-.414.414-.414zm-1.387.089c.178%200%20.31.147.31.325%200%20.162-.132.31-.31.31a.312.312%200%200%201-.31-.31c0-.178.133-.325.31-.325zm4.796%201.7a.725.725%200%200%201%200%201.449.722.722%200%200%201-.708-.725c0-.399.325-.724.708-.724zm-1.859.236c.28%200%20.502.222.502.488a.495.495%200%200%201-.989%200c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.192.414.414a.413.413%200%200%201-.413.414.404.404%200%200%201-.414-.414c0-.222.177-.414.414-.414zm-1.387.104c.178%200%20.31.133.31.31%200%20.178-.132.31-.31.31a.303.303%200%200%201-.31-.31c0-.177.133-.31.31-.31zm4.796%201.7c.399%200%20.723.325.723.71a.724.724%200%200%201-.723.724.722.722%200%200%201-.708-.724c0-.385.325-.71.708-.71zm-1.859.222a.495.495%200%201%201%20.014.99.495.495%200%200%201-.014-.99zm-1.55.074c.222%200%20.414.192.414.414a.426.426%200%200%201-.413.428.416.416%200%200%201-.414-.428c0-.222.177-.414.414-.414zm-1.387.103c.178%200%20.31.148.31.31a.315.315%200%200%201-.31.326.315.315%200%200%201-.31-.325c0-.163.133-.31.31-.31zm4.796%201.7a.725.725%200%200%201%200%201.45.722.722%200%200%201-.708-.725c0-.4.325-.725.708-.725zm-1.859.237c.28%200%20.502.222.502.488a.495.495%200%200%201-.989%200c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.177.414.414a.423.423%200%200%201-.413.414.413.413%200%200%201-.414-.414c0-.237.177-.414.414-.414zm-1.387.103c.178%200%20.31.133.31.31a.303.303%200%200%201-.31.311.303.303%200%200%201-.31-.31c0-.178.133-.31.31-.31zm-3.541-11.073a8.654%208.654%200%200%200-2.553%206.15c0%202.41.974%204.583%202.553%206.165l-3.424%203.43a13.53%2013.53%200%200%201-3.97-9.595c0-3.74%201.52-7.126%203.97-9.58zm15.716-3.43a13.522%2013.522%200%200%201%203.97%209.58c0%203.755-1.52%207.14-3.97%209.595l-3.424-3.43a8.689%208.689%200%200%200%202.553-6.165%208.654%208.654%200%200%200-2.553-6.15z'%20/%3e%3cpath%20fill='%23e62129'%20d='M19.317%2044.364a17.903%2017.903%200%200%201-5.254-12.7%2017.93%2017.93%200%200%201%205.254-12.7l-3.424-3.43c-4.117%204.14-6.67%209.832-6.67%2016.13a22.77%2022.77%200%200%200%206.67%2016.13z'%20/%3e%3cpath%20fill='%23e62129'%20d='M44.683%2018.965a17.916%2017.916%200%200%201%205.24%2012.7%2017.89%2017.89%200%200%201-5.24%2012.699l3.424%203.43a22.77%2022.77%200%200%200%206.67-16.13c0-6.298-2.553-11.99-6.67-16.13z'%20/%3e%3cpath%20fill='%23e62129'%20d='M51.206%2012.43a27.143%2027.143%200%200%201%207.954%2019.234c0%207.525-3.04%2014.326-7.954%2019.25l3.423%203.429A31.984%2031.984%200%200%200%2064%2031.664C64%2022.824%2060.429%2014.81%2054.63%209Z'%20/%3e%3cpath%20fill='%23e62129'%20d='M12.794%2050.913A27.152%2027.152%200%200%201%204.84%2031.664c0-7.51%203.04-14.311%207.954-19.234L9.371%209A31.975%2031.975%200%200%200%200%2031.664a31.984%2031.984%200%200%200%209.37%2022.679Z'%20/%3e%3c/svg%3e`,Mc=`data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='utf-8'?%3e%3c!--%20Generator:%20Adobe%20Illustrator%2014.0.0,%20SVG%20Export%20Plug-In%20.%20SVG%20Version:%206.00%20Build%2043363)%20--%3e%3c!DOCTYPE%20svg%20PUBLIC%20'-//W3C//DTD%20SVG%201.1//EN'%20'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'%3e%3csvg%20version='1.1'%20id='Layer_1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%20x='0px'%20y='0px'%20width='166.4px'%20height='64px'%20viewBox='0%200%20166.4%2064'%20enable-background='new%200%200%20166.4%2064'%20xml:space='preserve'%3e%3cg%3e%3cg%3e%3crect%20fill='%23FFFF00'%20width='12.8'%20height='64'/%3e%3crect%20x='25.599'%20fill='%23FFFF00'%20width='12.8'%20height='38.4'/%3e%3c/g%3e%3cg%3e%3cpolygon%20fill='%23FFFF00'%20points='51.2,25.6%2051.2,64%2064,64%2064,38.4%2089.6,38.4%2089.6,25.6%20'/%3e%3crect%20x='51.2'%20fill='%23FFFF00'%20width='38.4'%20height='12.8'/%3e%3c/g%3e%3crect%20x='102.4'%20fill='%23FFFF00'%20width='12.801'%20height='64'/%3e%3crect%20x='128'%20fill='%23FFFF00'%20width='12.801'%20height='64'/%3e%3crect%20x='153.6'%20fill='%23FFFF00'%20width='12.8'%20height='64'/%3e%3c/g%3e%3c/svg%3e`,Nc=e((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.fragment`);function r(e,n,r){var i=null;if(r!==void 0&&(i=``+r),n.key!==void 0&&(i=``+n.key),`key`in n)for(var a in r={},n)a!==`key`&&(r[a]=n[a]);else r=n;return n=r.ref,{$$typeof:t,type:e,key:i,ref:n===void 0?null:n,props:r}}e.Fragment=n,e.jsx=r,e.jsxs=r})),K=e(((e,t)=>{t.exports=Nc()}))();function Pc(){return(0,K.jsxs)(`header`,{className:d.header,children:[(0,K.jsxs)(`div`,{className:d.headerLeft,children:[(0,K.jsx)(`img`,{src:jc,alt:`LibreTime`,className:d.headerIcon}),(0,K.jsx)(`span`,{className:d.headerTitle,children:`LibreTime File Uploader`})]}),(0,K.jsxs)(`a`,{href:`https://powerfm.org`,target:`_blank`,rel:`noopener noreferrer`,className:d.headerRight,children:[(0,K.jsx)(`span`,{className:d.poweredBy,children:`powered by`}),(0,K.jsx)(`img`,{src:Mc,alt:`PowerFM`,className:d.powerFmLogo})]})]})}function Fc(){let{mode:e,uploadState:t,uploadedFile:n,errorMsg:r,file:i,url:a,libraries:o,selectedLibrary:s,metadata:c,busy:l,app:u,error:f,fileInputRef:p,handleFileChange:m,handleMetadataChange:h,handleFilePick:g,handleUrl:_,handleReset:v,setUrl:y,setSelectedLibrary:b}=Ac();return f?(0,K.jsxs)(`div`,{className:d.message,children:[`Error: `,f.message]}):!u||e===`loading`?(0,K.jsx)(`div`,{className:d.message,children:`Loading…`}):t===`success`&&n?(0,K.jsxs)(`div`,{className:d.wrapper,children:[(0,K.jsx)(Pc,{}),(0,K.jsxs)(`div`,{className:d.container,children:[(0,K.jsx)(`div`,{className:d.successIcon,children:`✓`}),(0,K.jsx)(`p`,{className:d.successLabel,children:`Uploaded successfully`}),(0,K.jsxs)(`dl`,{className:d.fileDetails,children:[(0,K.jsx)(`dt`,{children:`Title`}),(0,K.jsx)(`dd`,{children:n.track_title??n.name}),n.artist_name&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Artist`}),(0,K.jsx)(`dd`,{children:n.artist_name})]}),n.album_title&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Album`}),(0,K.jsx)(`dd`,{children:n.album_title})]}),n.genre&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Genre`}),(0,K.jsx)(`dd`,{children:n.genre})]}),(0,K.jsx)(`dt`,{children:`ID`}),(0,K.jsx)(`dd`,{children:n.id})]}),(0,K.jsx)(`button`,{className:d.button,onClick:v,children:`Upload another`})]})]}):(0,K.jsxs)(`div`,{className:d.wrapper,children:[(0,K.jsx)(Pc,{}),(0,K.jsxs)(`div`,{className:d.container,children:[e===`file-picker`?(0,K.jsxs)(`label`,{className:`${d.dropZone} ${i?d.dropZoneHasFile:``}`,children:[(0,K.jsx)(`input`,{ref:p,type:`file`,accept:`audio/*`,onChange:m,className:d.hiddenInput,disabled:l}),i?(0,K.jsx)(`span`,{className:d.fileName,children:i.name}):(0,K.jsx)(`span`,{className:d.dropHint,children:`Click to choose an audio file`})]}):(0,K.jsx)(`input`,{type:`url`,value:a,onChange:e=>y(e.target.value),placeholder:`https://example.com/show.mp3`,className:d.input,disabled:l}),o.length>0&&(0,K.jsxs)(`label`,{className:d.fieldLabel,children:[(0,K.jsx)(`span`,{className:d.fieldName,children:`Track type`}),(0,K.jsxs)(`select`,{value:s??``,onChange:e=>b(e.target.value?Number(e.target.value):null),className:d.input,disabled:l,children:[(0,K.jsx)(`option`,{value:``,children:`— Select —`}),o.filter(e=>e.enabled).map(e=>(0,K.jsx)(`option`,{value:e.id,children:e.name??e.code},e.id))]})]}),(0,K.jsx)(`div`,{className:d.fields,children:[`track_title`,`artist_name`,`album_title`,`genre`].map(e=>(0,K.jsxs)(`label`,{className:d.fieldLabel,children:[(0,K.jsx)(`span`,{className:d.fieldName,children:e.replace(`_`,` `)}),(0,K.jsx)(`input`,{type:`text`,value:c[e],onChange:h(e),className:d.input,disabled:l,placeholder:`Optional`})]},e))}),t===`error`&&(0,K.jsx)(`p`,{className:d.errorMsg,children:r}),(0,K.jsx)(`button`,{className:d.button,onClick:e===`file-picker`?g:_,disabled:l||(e===`file-picker`?!i:!a.trim()),children:l?`Uploading…`:`Upload`})]})]})}(0,u.createRoot)(document.getElementById(`root`)).render((0,K.jsx)(l.StrictMode,{children:(0,K.jsx)(Fc,{})}));</script>
+container holding the app. Specify either width or maxWidth, and either height or maxHeight.`),locale:j().optional().describe(`User's language and region preference in BCP 47 format.`),timeZone:j().optional().describe(`User's timezone in IANA format.`),userAgent:j().optional().describe(`Host application identifier.`),platform:R([B(`web`),B(`desktop`),B(`mobile`)]).optional().describe(`Platform type for responsive design decisions.`),deviceCapabilities:L({touch:N().optional().describe(`Whether the device supports touch input.`),hover:N().optional().describe(`Whether the device supports hover interactions.`)}).optional().describe(`Device input capabilities.`),safeAreaInsets:L({top:M().describe(`Top safe area inset in pixels.`),right:M().describe(`Right safe area inset in pixels.`),bottom:M().describe(`Bottom safe area inset in pixels.`),left:M().describe(`Left safe area inset in pixels.`)}).optional().describe(`Mobile safe area boundaries in pixels.`)}).passthrough(),Ec=L({method:B(`ui/notifications/host-context-changed`),params:Tc.describe(`Partial context update containing only changed fields.`)});L({method:B(`ui/update-model-context`),params:L({content:I(is).optional().describe(`Context content blocks (text, image, etc.).`),structuredContent:z(j(),P().describe(`Structured content for machine-readable context data.`)).optional().describe(`Structured content for machine-readable context data.`)})}),L({method:B(`ui/initialize`),params:L({appInfo:Ya.describe(`App identification (name and version).`),appCapabilities:xc.describe(`Features and capabilities this app provides.`),protocolVersion:j().describe(`Protocol version this app supports.`)})});var Dc=L({protocolVersion:j().describe(`Negotiated protocol version string (e.g., "2025-11-21").`),hostInfo:Ya.describe(`Host application identification and version.`),hostCapabilities:bc.describe(`Features and capabilities provided by the host.`),hostContext:Tc.describe(`Rich context about the host environment.`)}).passthrough(),Oc=class extends nc{_appInfo;_capabilities;options;_hostCapabilities;_hostInfo;_hostContext;constructor(e,t={},n={autoResize:!0}){super(n),this._appInfo=e,this._capabilities=t,this.options=n,this.setRequestHandler(ao,e=>(console.log(`Received ping:`,e.params),{})),this.onhostcontextchanged=()=>{}}getHostCapabilities(){return this._hostCapabilities}getHostVersion(){return this._hostInfo}getHostContext(){return this._hostContext}set ontoolinput(e){this.setNotificationHandler(pc,t=>e(t.params))}set ontoolinputpartial(e){this.setNotificationHandler(mc,t=>e(t.params))}set ontoolresult(e){this.setNotificationHandler(wc,t=>e(t.params))}set ontoolcancelled(e){this.setNotificationHandler(hc,t=>e(t.params))}set onhostcontextchanged(e){this.setNotificationHandler(Ec,t=>{this._hostContext={...this._hostContext,...t.params},e(t.params)})}set onteardown(e){this.setRequestHandler(vc,(t,n)=>e(t.params,n))}set oncalltool(e){this.setRequestHandler(hs,(t,n)=>e(t.params,n))}set onlisttools(e){this.setRequestHandler(ds,(t,n)=>e(t.params,n))}assertCapabilityForMethod(e){}assertRequestHandlerCapability(e){switch(e){case`tools/call`:case`tools/list`:if(!this._capabilities.tools)throw Error(`Client does not support tool capability (required for ${e})`);return;case`ping`:case`ui/resource-teardown`:return;default:throw Error(`No handler for method ${e} registered`)}}assertNotificationCapability(e){}assertTaskCapability(e){throw Error(`Tasks are not supported in MCP Apps`)}assertTaskHandlerCapability(e){throw Error(`Task handlers are not supported in MCP Apps`)}async callServerTool(e,t){if(typeof e==`string`)throw Error(`callServerTool() expects an object as its first argument, but received a string ("${e}"). Did you mean: callServerTool({ name: "${e}", arguments: { ... } })?`);return await this.request({method:`tools/call`,params:e},ps,t)}async readServerResource(e,t){return await this.request({method:`resources/read`,params:e},Ro,t)}async listServerResources(e,t){return await this.request({method:`resources/list`,params:e},Mo,t)}sendMessage(e,t){return this.request({method:`ui/message`,params:e},uc,t)}sendLog(e){return this.notification({method:`notifications/message`,params:e})}updateModelContext(e,t){return this.request({method:`ui/update-model-context`,params:e},Wa,t)}openLink(e,t){return this.request({method:`ui/open-link`,params:e},cc,t)}sendOpenLink=this.openLink;downloadFile(e,t){return this.request({method:`ui/download-file`,params:e},lc,t)}requestTeardown(e={}){return this.notification({method:`ui/notifications/request-teardown`,params:e})}requestDisplayMode(e,t){return this.request({method:`ui/request-display-mode`,params:e},Sc,t)}sendSizeChanged(e){return this.notification({method:`ui/notifications/size-changed`,params:e})}setupSizeChangedNotifications(){let e=!1,t=0,n=0,r=()=>{e||(e=!0,requestAnimationFrame(()=>{e=!1;let r=document.documentElement,i=r.style.height;r.style.height=`max-content`;let a=Math.ceil(r.getBoundingClientRect().height);r.style.height=i;let o=Math.ceil(window.innerWidth);(o!==t||a!==n)&&(t=o,n=a,this.sendSizeChanged({width:o,height:a}))}))};r();let i=new ResizeObserver(r);return i.observe(document.documentElement),i.observe(document.body),()=>i.disconnect()}async connect(e=new ic(window.parent,window.parent),t){if(this.transport)throw Error(`App is already connected. Call close() before connecting again.`);await super.connect(e);try{let e=await this.request({method:`ui/initialize`,params:{appCapabilities:this._capabilities,appInfo:this._appInfo,protocolVersion:rc}},Dc,t);if(e===void 0)throw Error(`Server sent invalid initialize result: ${e}`);this._hostCapabilities=e.hostCapabilities,this._hostInfo=e.hostInfo,this._hostContext=e.hostContext,await this.notification({method:`ui/notifications/initialized`}),this.options?.autoResize&&this.setupSizeChangedNotifications()}catch(e){throw this.close(),e}}};function kc({appInfo:e,capabilities:t,onAppCreated:n}){let[r,i]=(0,l.useState)(null),[a,o]=(0,l.useState)(!1),[s,c]=(0,l.useState)(null);return(0,l.useEffect)(()=>{let r=!0;async function a(){try{let a=new ic(window.parent,window.parent),s=new Oc(e,t);n?.(s),await s.connect(a),r&&(i(s),o(!0),c(null))}catch(e){r&&(i(null),o(!1),c(e instanceof Error?e:Error(`Failed to connect`)))}}return a(),()=>{r=!1}},[]),{app:r,isConnected:a,error:s}}function Ac(){let[e,t]=(0,l.useState)(`loading`),[n,r]=(0,l.useState)(`idle`),[i,a]=(0,l.useState)(null),[o,s]=(0,l.useState)(``),[c,u]=(0,l.useState)(null),[d,f]=(0,l.useState)(null),[p,m]=(0,l.useState)(null),h=(0,l.useRef)(null),[g,_]=(0,l.useState)([]),[v,y]=(0,l.useState)(null),[b,x]=(0,l.useState)({track_title:``,artist_name:``,album_title:``,genre:``}),{app:S,error:ee}=kc({appInfo:{name:`LibreTime File Uploader`,version:`1.0.0`},capabilities:{},onAppCreated:e=>{e.ontoolinput=async e=>{let t=e.arguments;t&&x(e=>({track_title:t.track_title??e.track_title,artist_name:t.artist_name??e.artist_name,album_title:t.album_title??e.album_title,genre:t.genre??e.genre}))},e.ontoolresult=async e=>{let n=e.content?.find(e=>e.type===`text`)?.text;if(n)try{let e=JSON.parse(n);if(e.status===`success`&&e.file){a(e.file),r(`success`);return}u(e.upload_url??null),f(e.upload_token??null),_(e.libraries??[]),t(`ready`)}catch{}},e.onteardown=async()=>({}),e.onerror=console.error}}),C=(0,l.useCallback)(e=>{let t=e.target.files?.[0]??null;if(m(t),t&&!b.track_title){let e=t.name.replace(/\.[^.]+$/,``);x(t=>({...t,track_title:t.track_title||e}))}},[b.track_title]),te=(0,l.useCallback)(e=>t=>{x(n=>({...n,[e]:t.target.value}))},[]),ne=(0,l.useCallback)(async()=>{if(!(!p||!c||!d)){r(`uploading`);try{let e=new FormData;e.append(`file`,p,p.name),e.append(`name`,p.name),e.append(`mime`,p.type||`audio/mpeg`),e.append(`size`,String(p.size)),e.append(`accessed`,String(Math.floor(Date.now()/1e3)));for(let[t,n]of Object.entries(b))n.trim()&&e.append(t,n.trim());v!==null&&e.append(`library`,String(v));let t=await fetch(c,{method:`POST`,headers:{"X-Upload-Token":d},body:e});if(!t.ok){let e=await t.json().catch(()=>({error:t.statusText})),n=e.detail;s(`${e.error??`Upload failed`}${n?`: ${n}`:``}`),r(`error`);return}let n=await t.json();a(n),r(`success`),await S?.updateModelContext({content:[{type:`text`,text:`File uploaded: "${n.track_title??n.name}" (ID: ${n.id})`}]})}catch(e){s(e instanceof Error?e.message:String(e)),r(`error`)}}},[p,c,d,b,v,S]),re=(0,l.useCallback)(()=>{m(null),r(`idle`),s(``),a(null),h.current&&(h.current.value=``)},[]);return{mode:e,uploadState:n,uploadedFile:i,errorMsg:o,file:p,libraries:g,selectedLibrary:v,metadata:b,busy:n===`uploading`,app:S,error:ee,fileInputRef:h,handleFileChange:C,handleMetadataChange:te,handleFilePick:ne,handleReset:re,setSelectedLibrary:y}}var jc=`data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20xml:space='preserve'%20viewBox='0%200%2064%2064'%20clip-rule='evenodd'%20fill-rule='evenodd'%20image-rendering='optimizeQuality'%20shape-rendering='geometricPrecision'%20text-rendering='geometricPrecision'%3e%3cpath%20fill='%23474443'%20d='M31.993%2018.107c3.32%200%206.36%201.198%208.706%203.179l-3.438%203.444a8.687%208.687%200%200%200-10.522%200l-3.438-3.444a13.443%2013.443%200%200%201%208.692-3.179zm2.08%2026.966L35.711%2059h-7.437l1.653-13.927a13.44%2013.44%200%200%201-6.626-3.016l3.438-3.444a8.72%208.72%200%200%200%204.412%201.73v-1.73h-.84c-1.034%200-1.875-.858-1.875-1.893v-8.072c0-1.035.841-1.892%201.874-1.892h3.38c1.033%200%201.874.857%201.874%201.892v8.072c0%201.035-.841%201.893-1.874%201.893h-.841v1.73a8.72%208.72%200%200%200%204.412-1.73l3.438%203.444a13.44%2013.44%200%200%201-6.626%203.016zm.118-17.312c.399%200%20.723.31.723.71a.724.724%200%200%201-.723.724.722.722%200%200%201-.708-.724c0-.4.325-.71.708-.71zm-1.859.222c.28%200%20.502.222.502.488%200%20.28-.222.488-.502.488a.482.482%200%200%201-.487-.488c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.192.414.414a.413.413%200%200%201-.413.414.404.404%200%200%201-.414-.414c0-.222.177-.414.414-.414zm-1.387.103c.178%200%20.31.133.31.31a.303.303%200%200%201-.31.311.303.303%200%200%201-.31-.31c0-.178.133-.31.31-.31zm4.796%201.7c.399%200%20.723.326.723.725%200%20.384-.324.71-.723.71a.719.719%200%200%201-.708-.71c0-.4.325-.725.708-.725zm-1.859.222a.496.496%200%201%201%20.014.991.495.495%200%200%201-.014-.99zm-1.55.089c.222%200%20.414.177.414.414a.423.423%200%200%201-.413.414.413.413%200%200%201-.414-.414c0-.237.177-.414.414-.414zm-1.387.089c.178%200%20.31.147.31.325%200%20.162-.132.31-.31.31a.312.312%200%200%201-.31-.31c0-.178.133-.325.31-.325zm4.796%201.7a.725.725%200%200%201%200%201.449.722.722%200%200%201-.708-.725c0-.399.325-.724.708-.724zm-1.859.236c.28%200%20.502.222.502.488a.495.495%200%200%201-.989%200c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.192.414.414a.413.413%200%200%201-.413.414.404.404%200%200%201-.414-.414c0-.222.177-.414.414-.414zm-1.387.104c.178%200%20.31.133.31.31%200%20.178-.132.31-.31.31a.303.303%200%200%201-.31-.31c0-.177.133-.31.31-.31zm4.796%201.7c.399%200%20.723.325.723.71a.724.724%200%200%201-.723.724.722.722%200%200%201-.708-.724c0-.385.325-.71.708-.71zm-1.859.222a.495.495%200%201%201%20.014.99.495.495%200%200%201-.014-.99zm-1.55.074c.222%200%20.414.192.414.414a.426.426%200%200%201-.413.428.416.416%200%200%201-.414-.428c0-.222.177-.414.414-.414zm-1.387.103c.178%200%20.31.148.31.31a.315.315%200%200%201-.31.326.315.315%200%200%201-.31-.325c0-.163.133-.31.31-.31zm4.796%201.7a.725.725%200%200%201%200%201.45.722.722%200%200%201-.708-.725c0-.4.325-.725.708-.725zm-1.859.237c.28%200%20.502.222.502.488a.495.495%200%200%201-.989%200c0-.266.221-.488.487-.488zm-1.55.074c.222%200%20.414.177.414.414a.423.423%200%200%201-.413.414.413.413%200%200%201-.414-.414c0-.237.177-.414.414-.414zm-1.387.103c.178%200%20.31.133.31.31a.303.303%200%200%201-.31.311.303.303%200%200%201-.31-.31c0-.178.133-.31.31-.31zm-3.541-11.073a8.654%208.654%200%200%200-2.553%206.15c0%202.41.974%204.583%202.553%206.165l-3.424%203.43a13.53%2013.53%200%200%201-3.97-9.595c0-3.74%201.52-7.126%203.97-9.58zm15.716-3.43a13.522%2013.522%200%200%201%203.97%209.58c0%203.755-1.52%207.14-3.97%209.595l-3.424-3.43a8.689%208.689%200%200%200%202.553-6.165%208.654%208.654%200%200%200-2.553-6.15z'%20/%3e%3cpath%20fill='%23e62129'%20d='M19.317%2044.364a17.903%2017.903%200%200%201-5.254-12.7%2017.93%2017.93%200%200%201%205.254-12.7l-3.424-3.43c-4.117%204.14-6.67%209.832-6.67%2016.13a22.77%2022.77%200%200%200%206.67%2016.13z'%20/%3e%3cpath%20fill='%23e62129'%20d='M44.683%2018.965a17.916%2017.916%200%200%201%205.24%2012.7%2017.89%2017.89%200%200%201-5.24%2012.699l3.424%203.43a22.77%2022.77%200%200%200%206.67-16.13c0-6.298-2.553-11.99-6.67-16.13z'%20/%3e%3cpath%20fill='%23e62129'%20d='M51.206%2012.43a27.143%2027.143%200%200%201%207.954%2019.234c0%207.525-3.04%2014.326-7.954%2019.25l3.423%203.429A31.984%2031.984%200%200%200%2064%2031.664C64%2022.824%2060.429%2014.81%2054.63%209Z'%20/%3e%3cpath%20fill='%23e62129'%20d='M12.794%2050.913A27.152%2027.152%200%200%201%204.84%2031.664c0-7.51%203.04-14.311%207.954-19.234L9.371%209A31.975%2031.975%200%200%200%200%2031.664a31.984%2031.984%200%200%200%209.37%2022.679Z'%20/%3e%3c/svg%3e`,Mc=`data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='utf-8'?%3e%3c!--%20Generator:%20Adobe%20Illustrator%2014.0.0,%20SVG%20Export%20Plug-In%20.%20SVG%20Version:%206.00%20Build%2043363)%20--%3e%3c!DOCTYPE%20svg%20PUBLIC%20'-//W3C//DTD%20SVG%201.1//EN'%20'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'%3e%3csvg%20version='1.1'%20id='Layer_1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%20x='0px'%20y='0px'%20width='166.4px'%20height='64px'%20viewBox='0%200%20166.4%2064'%20enable-background='new%200%200%20166.4%2064'%20xml:space='preserve'%3e%3cg%3e%3cg%3e%3crect%20fill='%23FFFF00'%20width='12.8'%20height='64'/%3e%3crect%20x='25.599'%20fill='%23FFFF00'%20width='12.8'%20height='38.4'/%3e%3c/g%3e%3cg%3e%3cpolygon%20fill='%23FFFF00'%20points='51.2,25.6%2051.2,64%2064,64%2064,38.4%2089.6,38.4%2089.6,25.6%20'/%3e%3crect%20x='51.2'%20fill='%23FFFF00'%20width='38.4'%20height='12.8'/%3e%3c/g%3e%3crect%20x='102.4'%20fill='%23FFFF00'%20width='12.801'%20height='64'/%3e%3crect%20x='128'%20fill='%23FFFF00'%20width='12.801'%20height='64'/%3e%3crect%20x='153.6'%20fill='%23FFFF00'%20width='12.8'%20height='64'/%3e%3c/g%3e%3c/svg%3e`,Nc=e((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.fragment`);function r(e,n,r){var i=null;if(r!==void 0&&(i=``+r),n.key!==void 0&&(i=``+n.key),`key`in n)for(var a in r={},n)a!==`key`&&(r[a]=n[a]);else r=n;return n=r.ref,{$$typeof:t,type:e,key:i,ref:n===void 0?null:n,props:r}}e.Fragment=n,e.jsx=r,e.jsxs=r})),K=e(((e,t)=>{t.exports=Nc()}))();function Pc(){return(0,K.jsxs)(`header`,{className:d.header,children:[(0,K.jsxs)(`div`,{className:d.headerLeft,children:[(0,K.jsx)(`img`,{src:jc,alt:`LibreTime`,className:d.headerIcon}),(0,K.jsx)(`span`,{className:d.headerTitle,children:`LibreTime File Uploader`})]}),(0,K.jsxs)(`a`,{href:`https://powerfm.org`,target:`_blank`,rel:`noopener noreferrer`,className:d.headerRight,children:[(0,K.jsx)(`span`,{className:d.poweredBy,children:`powered by`}),(0,K.jsx)(`img`,{src:Mc,alt:`PowerFM`,className:d.powerFmLogo})]})]})}function Fc(){let{mode:e,uploadState:t,uploadedFile:n,errorMsg:r,file:i,libraries:a,selectedLibrary:o,metadata:s,busy:c,app:l,error:u,fileInputRef:f,handleFileChange:p,handleMetadataChange:m,handleFilePick:h,handleReset:g,setSelectedLibrary:_}=Ac();return u?(0,K.jsxs)(`div`,{className:d.message,children:[`Error: `,u.message]}):!l||e===`loading`?(0,K.jsx)(`div`,{className:d.message,children:`Loading…`}):t===`success`&&n?(0,K.jsxs)(`div`,{className:d.wrapper,children:[(0,K.jsx)(Pc,{}),(0,K.jsxs)(`div`,{className:d.container,children:[(0,K.jsx)(`div`,{className:d.successIcon,children:`✓`}),(0,K.jsx)(`p`,{className:d.successLabel,children:`Uploaded successfully`}),(0,K.jsxs)(`dl`,{className:d.fileDetails,children:[(0,K.jsx)(`dt`,{children:`Title`}),(0,K.jsx)(`dd`,{children:n.track_title??n.name}),n.artist_name&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Artist`}),(0,K.jsx)(`dd`,{children:n.artist_name})]}),n.album_title&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Album`}),(0,K.jsx)(`dd`,{children:n.album_title})]}),n.genre&&(0,K.jsxs)(K.Fragment,{children:[(0,K.jsx)(`dt`,{children:`Genre`}),(0,K.jsx)(`dd`,{children:n.genre})]}),(0,K.jsx)(`dt`,{children:`ID`}),(0,K.jsx)(`dd`,{children:n.id})]}),(0,K.jsx)(`button`,{className:d.button,onClick:g,children:`Upload another`})]})]}):(0,K.jsxs)(`div`,{className:d.wrapper,children:[(0,K.jsx)(Pc,{}),(0,K.jsxs)(`div`,{className:d.container,children:[(0,K.jsxs)(`label`,{className:`${d.dropZone} ${i?d.dropZoneHasFile:``}`,children:[(0,K.jsx)(`input`,{ref:f,type:`file`,accept:`audio/*`,onChange:p,className:d.hiddenInput,disabled:c}),i?(0,K.jsx)(`span`,{className:d.fileName,children:i.name}):(0,K.jsx)(`span`,{className:d.dropHint,children:`Click to choose an audio file`})]}),a.length>0&&(0,K.jsxs)(`label`,{className:d.fieldLabel,children:[(0,K.jsx)(`span`,{className:d.fieldName,children:`Track type`}),(0,K.jsxs)(`select`,{value:o??``,onChange:e=>_(e.target.value?Number(e.target.value):null),className:d.input,disabled:c,children:[(0,K.jsx)(`option`,{value:``,children:`— Select —`}),a.filter(e=>e.enabled).map(e=>(0,K.jsx)(`option`,{value:e.id,children:e.name??e.code},e.id))]})]}),(0,K.jsx)(`div`,{className:d.fields,children:[`track_title`,`artist_name`,`album_title`,`genre`].map(e=>(0,K.jsxs)(`label`,{className:d.fieldLabel,children:[(0,K.jsx)(`span`,{className:d.fieldName,children:e.replace(`_`,` `)}),(0,K.jsx)(`input`,{type:`text`,value:s[e],onChange:m(e),className:d.input,disabled:c,placeholder:`Optional`})]},e))}),t===`error`&&(0,K.jsx)(`p`,{className:d.errorMsg,children:r}),(0,K.jsx)(`button`,{className:d.button,onClick:h,disabled:c||!i,children:c?`Uploading…`:`Upload`})]})]})}(0,u.createRoot)(document.getElementById(`root`)).render((0,K.jsx)(l.StrictMode,{children:(0,K.jsx)(Fc,{})}));</script>
   <style rel="stylesheet" crossorigin>:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light dark;--color-text-primary:var(--lightningcss-light,#1f2937)var(--lightningcss-dark,#f3f4f6);--color-text-secondary:var(--lightningcss-light,#6b7280)var(--lightningcss-dark,#9ca3af);--color-text-inverse:var(--lightningcss-light,#f3f4f6)var(--lightningcss-dark,#1f2937);--color-background-primary:var(--lightningcss-light,#fff)var(--lightningcss-dark,#1a1a1a);--color-background-secondary:var(--lightningcss-light,#f9fafb)var(--lightningcss-dark,#2a2a2a);--color-border:var(--lightningcss-light,#e5e7eb)var(--lightningcss-dark,#374151);--color-accent:#2563eb;--color-text-on-accent:#fff;--color-success:var(--lightningcss-light,#16a34a)var(--lightningcss-dark,#4ade80);--color-error:var(--lightningcss-light,#dc2626)var(--lightningcss-dark,#f87171);--border-radius-md:6px;--border-width-regular:1px;--font-sans:ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-weight-normal:400;--font-weight-bold:700;--font-text-md-size:1rem;--font-text-md-line-height:1.5;--font-heading-md-size:1rem;--font-heading-md-line-height:1.4;--spacing-unit:var(--font-text-md-size);--spacing-xs:calc(var(--spacing-unit) * .25);--spacing-sm:calc(var(--spacing-unit) * .5);--spacing-md:var(--spacing-unit);--spacing-lg:calc(var(--spacing-unit) * 1.5)}@media (prefers-color-scheme:dark){:root{--lightningcss-light: ;--lightningcss-dark:initial}}*{box-sizing:border-box}html,body{font-family:var(--font-sans);font-size:var(--font-text-md-size);font-weight:var(--font-weight-normal);line-height:var(--font-text-md-line-height);color:var(--color-text-primary);background:var(--color-background-primary);margin:0;padding:0}._message_1x8vx_1{padding:var(--spacing-md);font-size:.875rem}._wrapper_1x8vx_6{--color-background-primary:#3d3d3d;--color-background-secondary:#2d2d2d;--color-text-primary:#e0e0e0;--color-text-secondary:#bdbdbd;--color-border:#555;--color-error:#f87171;background:#333;flex-direction:column;width:100%;min-height:100%;display:flex}._header_1x8vx_21{padding:var(--spacing-sm) var(--spacing-md);background:#2d2d2d;border-bottom:2px solid #ff0;justify-content:space-between;align-items:center;display:flex}._headerLeft_1x8vx_30{align-items:center;gap:var(--spacing-sm);display:flex}._headerIcon_1x8vx_36{flex-shrink:0;width:24px;height:24px}._headerTitle_1x8vx_42{font-size:var(--font-text-md-size);font-weight:var(--font-weight-bold);color:#fff}._headerRight_1x8vx_48{flex-direction:column;align-items:flex-end;gap:2px;text-decoration:none;display:flex}._poweredBy_1x8vx_56{text-transform:uppercase;letter-spacing:.05em;color:#999;font-size:.625rem}._powerFmLogo_1x8vx_63{width:auto;height:30px}._successLabel_1x8vx_68{color:var(--color-text-secondary);margin:0;font-size:.875rem}._container_1x8vx_74{padding:var(--spacing-md);gap:var(--spacing-md);box-sizing:border-box;flex-direction:column;width:100%;display:flex}._heading_1x8vx_83{font-size:var(--font-heading-md-size);line-height:var(--font-heading-md-line-height);font-weight:var(--font-weight-bold);margin:0}._dropZone_1x8vx_90{padding:var(--spacing-lg);border:2px dashed var(--color-border);border-radius:var(--border-radius-md);background:var(--color-background-secondary);cursor:pointer;justify-content:center;align-items:center;min-height:80px;transition:border-color .15s;display:flex}._dropZone_1x8vx_90:hover{border-color:#ff0}._dropZoneHasFile_1x8vx_107{border-style:solid;border-color:#ff0}._hiddenInput_1x8vx_112{clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}._dropHint_1x8vx_122{color:var(--color-text-secondary);font-size:.875rem}._fileName_1x8vx_127{word-break:break-all;text-align:center;font-size:.875rem}._fields_1x8vx_133{gap:var(--spacing-sm);flex-direction:column;display:flex}._fieldLabel_1x8vx_139{gap:var(--spacing-xs);flex-direction:column;display:flex}._fieldName_1x8vx_145{font-size:.75rem;font-weight:var(--font-weight-bold);text-transform:capitalize;color:var(--color-text-secondary)}._input_1x8vx_152{width:100%;padding:var(--spacing-xs) var(--spacing-sm);border:var(--border-width-regular) solid var(--color-border);border-radius:var(--border-radius-md);background:var(--color-background-primary);color:var(--color-text-primary);font-family:var(--font-sans);font-size:var(--font-text-md-size)}._input_1x8vx_152::placeholder{color:var(--color-text-secondary);opacity:1}._input_1x8vx_152:focus{border-color:#ff0;outline:none}._button_1x8vx_173{padding:var(--spacing-sm) var(--spacing-md);color:#1a1a1a;border-radius:var(--border-radius-md);font-family:var(--font-sans);font-size:var(--font-text-md-size);font-weight:var(--font-weight-bold);cursor:pointer;background:#ff0;border:none;transition:opacity .15s}._button_1x8vx_173:hover:not(:disabled){opacity:.9}._button_1x8vx_173:disabled{opacity:.5;cursor:not-allowed}._errorMsg_1x8vx_195{color:var(--color-error);margin:0;font-size:.875rem}._success_1x8vx_68{align-items:flex-start;gap:var(--spacing-md);flex-direction:column;display:flex}._successIcon_1x8vx_208{background:var(--color-success);color:#fff;width:40px;height:40px;font-size:1.25rem;font-weight:var(--font-weight-bold);border-radius:50%;justify-content:center;align-items:center;display:flex}._fileDetails_1x8vx_221{gap:var(--spacing-xs) var(--spacing-md);grid-template-columns:auto 1fr;margin:0;font-size:.875rem;display:grid}._fileDetails_1x8vx_221 dt{color:var(--color-text-secondary);font-weight:var(--font-weight-bold);text-transform:capitalize}._fileDetails_1x8vx_221 dd{margin:0}._connecting_1x8vx_239,._error_1x8vx_195{padding:var(--spacing-md);font-size:.875rem}._error_1x8vx_195{color:var(--color-error)}
 /*$vite$:1*/</style>
 </head>

package/dist/http/admin.js

@@ -9,6 +9,8 @@ import { register as registerShows } from '../tools/shows/index.js';
 import { register as registerAnalytics } from '../tools/analytics/index.js';
 import { register as registerAdmin } from '../tools/admin/index.js';
 import { register as registerFiles } from '../tools/files/index.js';
+import { register as registerPlaylists } from '../tools/playlists/index.js';
+import { register as registerPrompts } from '../prompts/index.js';
 import { registerUploadEndpoint } from './upload.js';
 import { createHttpServer } from './server.js';
 const PORT = parseInt(process.env.MCP_PORT ?? '3000', 10);
@@ -30,5 +32,7 @@ createHttpServer({
         registerAnalytics(server);
         registerAdmin(server);
         registerFiles(server, uploadUrl, UPLOAD_TOKEN);
+        registerPlaylists(server);
+        registerPrompts(server);
     },
 });

package/dist/http/client.js

@@ -5,11 +5,13 @@
 // Intended for network clients. For Claude Desktop use stdio/client.ts.
 import '../env.js';
 import { register as registerShows } from '../tools/shows/index.js';
+import { register as registerPrompts } from '../prompts/index.js';
 import { createHttpServer } from './server.js';
 createHttpServer({
     name: 'libretime-mcp-client',
     defaultPort: 3001,
     register: (server) => {
         registerShows(server);
+        registerPrompts(server);
     },
 });

package/dist/http/upload.js

@@ -30,10 +30,12 @@ export function registerUploadEndpoint(app, publicUrl, uploadToken) {
             return;
         }
         const BASE_URL = process.env.LIBRETIME_URL ?? '';
-        const USER = process.env.LIBRETIME_USER ?? '';
-        const PASS = process.env.LIBRETIME_PASS ?? '';
-        const libreAuth = 'Basic ' + Buffer.from(`${USER}:${PASS}`).toString('base64');
-        const libreUrl = new URL('/api/v2/files', BASE_URL).toString();
+        // /rest/media is the legacy PHP upload endpoint — the only path that writes
+        // files to disk and queues the analyzer. Auth uses the LibreTime API key
+        // (from config.yml general.api_key) as the Basic Auth username with no password.
+        const API_KEY = process.env.LIBRETIME_API_KEY ?? '';
+        const libreAuth = 'Basic ' + Buffer.from(`${API_KEY}:`).toString('base64');
+        const libreUrl = new URL('/rest/media', BASE_URL).toString();
         try {
             const body = await new Promise((resolve, reject) => {
                 const chunks = [];

package/dist/libretime.js

@@ -1,6 +1,7 @@
 const BASE_URL = process.env.LIBRETIME_URL ?? '';
 const USER = process.env.LIBRETIME_USER ?? '';
 const PASS = process.env.LIBRETIME_PASS ?? '';
+const API_KEY = process.env.LIBRETIME_API_KEY ?? '';
 // Basic Auth header value, base64-encoded as the HTTP spec requires
 const authHeader = 'Basic ' + Buffer.from(`${USER}:${PASS}`).toString('base64');
 /**
@@ -46,8 +47,11 @@ export async function librePost(path, body) {
     return response.json();
 }
 /**
- * Make an authenticated multipart POST request to the LibreTime API.
- * Used for file uploads. Returns the parsed JSON response as unknown.
+ * BENCHED: multipart POST to /api/v2/files (DRF).
+ * Creates a DB record but never writes to disk or queues the analyzer —
+ * filepath stays null and import_status stays 1 forever.
+ * Kept here for when the DRF endpoint gets the analyzer wiring fixed upstream.
+ * See: PLAN.md → Open source contributions → LibreTime file upload
  */
 export async function libreUpload(path, formData) {
     const url = new URL(path, BASE_URL);
@@ -56,8 +60,6 @@ export async function libreUpload(path, formData) {
         headers: {
             Authorization: authHeader,
             Accept: 'application/json',
-            // Note: do NOT set Content-Type here — fetch sets it automatically
-            // with the correct multipart boundary when given a FormData body
         },
         body: formData,
     });
@@ -66,6 +68,32 @@ export async function libreUpload(path, formData) {
     }
     return response.json();
 }
+/**
+ * Upload a file to /rest/media — the legacy PHP endpoint that triggers the full
+ * import workflow (writes to disk, queues the analyzer). The DRF /api/v2/files
+ * endpoint creates a DB record but never writes to disk, so this is the only
+ * working upload path.
+ *
+ * Auth uses LIBRETIME_API_KEY (general.api_key from LibreTime config.yml) as
+ * Basic Auth username with no password, which is what /rest/media expects.
+ */
+export async function libreRestMedia(formData) {
+    const url = new URL('/rest/media', BASE_URL);
+    const apiKeyAuth = 'Basic ' + Buffer.from(`${API_KEY}:`).toString('base64');
+    const response = await fetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            Authorization: apiKeyAuth,
+            Accept: 'application/json',
+            // Do NOT set Content-Type — fetch sets it with the correct multipart boundary
+        },
+        body: formData,
+    });
+    if (!response.ok) {
+        throw new Error(`LibreTime upload error: ${response.status} ${response.statusText} — ${url.toString()}`);
+    }
+    return response.json();
+}
 /**
  * Make an authenticated PATCH request to the LibreTime API with a JSON body.
  * Returns the parsed JSON response as unknown — callers are responsible for validation.

package/dist/prompts/index.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export function register(server) {
+    server.registerPrompt('on_air_now', {
+        description: 'Check what is currently on air and what is coming up next',
+    }, () => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: 'What is currently on air right now, and what shows are coming up next? Use get_stream_state for the live status and get_schedule to check today\'s schedule.',
+                },
+            }],
+    }));
+    server.registerPrompt('station_status', {
+        description: 'Full station overview — stream state, current schedule, and configuration',
+    }, () => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: 'Give me a full status overview of the station. Check get_stream_state for what is on air, get_schedule for the upcoming schedule, and get_station_info for the station configuration.',
+                },
+            }],
+    }));
+    server.registerPrompt('show_overview', {
+        description: 'Get a full overview of a specific show including upcoming instances',
+        argsSchema: {
+            show_name: z.string().describe('Name of the show'),
+        },
+    }, ({ show_name }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Give me a full overview of the show called "${show_name}". Use get_shows to find it by name, then get_show_instances to list its upcoming scheduled slots.`,
+                },
+            }],
+    }));
+    server.registerPrompt('upload_and_schedule', {
+        description: 'Upload an audio file and schedule it into a show',
+        argsSchema: {
+            show_name: z.string().describe('Name of the show to schedule the file into'),
+        },
+    }, ({ show_name }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `I want to upload an audio file and schedule it into the show called "${show_name}". Start by using upload_file to get the file from me. Once it is uploaded, use get_shows to find the show, get_show_instances to find the next available instance, then schedule_file to add it to the schedule.`,
+                },
+            }],
+    }));
+    server.registerPrompt('manage_playlist', {
+        description: 'View or manage playlists — list all playlists or inspect a specific one',
+        argsSchema: {
+            playlist_name: z.string().optional().describe('Name of a specific playlist to inspect. Leave blank to list all playlists.'),
+        },
+    }, ({ playlist_name }) => {
+        const text = playlist_name
+            ? `Show me the contents of the playlist called "${playlist_name}". Use get_playlists to find it by name, then get_playlist_contents to list its tracks.`
+            : 'List all playlists in the media library using get_playlists, and show the contents of each one using get_playlist_contents.';
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text } }],
+        };
+    });
+}

package/dist/stdio/admin.js

@@ -1,12 +1,28 @@
 #!/usr/bin/env node
 import { createRequire } from 'module';
+import crypto from 'node:crypto';
+import express from 'express';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { register as registerShows } from '../tools/shows/index.js';
 import { register as registerAnalytics } from '../tools/analytics/index.js';
 import { register as registerAdmin } from '../tools/admin/index.js';
 import { register as registerFiles } from '../tools/files/index.js';
+import { register as registerPlaylists } from '../tools/playlists/index.js';
+import { register as registerPrompts } from '../prompts/index.js';
+import { registerUploadEndpoint } from '../http/upload.js';
 const { version } = createRequire(import.meta.url)('../../package.json');
+// Spin up a local HTTP server solely for the file upload endpoint.
+// The MCP protocol runs over stdio — this is a side-channel so the
+// iframe UI can POST files without going through the MCP protocol.
+const UPLOAD_PORT = parseInt(process.env.UPLOAD_PORT ?? '4000', 10);
+const PUBLIC_URL = `http://localhost:${UPLOAD_PORT}`;
+const UPLOAD_TOKEN = crypto.randomBytes(32).toString('hex');
+const app = express();
+const uploadUrl = registerUploadEndpoint(app, PUBLIC_URL, UPLOAD_TOKEN);
+app.listen(UPLOAD_PORT, () => {
+    console.error(`Upload:   POST /upload on port ${UPLOAD_PORT}`);
+});
 const server = new McpServer({
     name: 'libretime-mcp-admin',
     version,
@@ -14,7 +30,9 @@ const server = new McpServer({
 registerShows(server);
 registerAnalytics(server);
 registerAdmin(server);
-registerFiles(server);
+registerFiles(server, uploadUrl, UPLOAD_TOKEN);
+registerPlaylists(server);
+registerPrompts(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error('LibreTime MCP admin server running (shows + analytics + admin)');

package/dist/stdio/client.js

@@ -3,12 +3,14 @@ import { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { register as registerShows } from '../tools/shows/index.js';
+import { register as registerPrompts } from '../prompts/index.js';
 const { version } = createRequire(import.meta.url)('../../package.json');
 const server = new McpServer({
     name: 'libretime-mcp-client',
     version,
 });
 registerShows(server);
+registerPrompts(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error('LibreTime MCP client server running (read-only: shows)');

package/dist/tools/admin/get_hosts.js

@@ -3,9 +3,7 @@ import { libreGet } from '../../libretime.js';
 import { toolText } from '../../tool-response.js';
 import { ShowHostSchema, UserSchema } from './types.js';
 export function register(server) {
-    server.registerTool('get_hosts', {
-        description: 'Get all show-to-host assignments. Enriches each entry with user details so you can see which presenter hosts which show by name.',
-    }, async () => {
+    server.tool('get_hosts', 'Get all show-to-host assignments. Enriches each entry with user details so you can see which presenter hosts which show by name.', {}, async () => {
         const [rawHosts, rawUsers] = await Promise.all([
             libreGet('/api/v2/show-hosts'),
             libreGet('/api/v2/users'),

package/dist/tools/admin/get_users.js

@@ -3,13 +3,18 @@ import { libreGet } from '../../libretime.js';
 import { toolText } from '../../tool-response.js';
 import { UserSchema } from './types.js';
 export function register(server) {
-    server.registerTool('get_users', {
-        description: 'List all LibreTime users (presenters and admins). Returns id, username, name, email, and role. Roles: G = Guest, H = Host, P = Manager, A = Admin.',
-    }, async () => {
+    server.tool('get_users', 'List all LibreTime users (presenters and admins). Returns id, username, name, and role. Roles: G = Guest, H = Host, P = Manager, A = Admin.', {
+        include_email: z.boolean().optional().describe('Include email addresses in the response (default: false)'),
+    }, async ({ include_email = false }) => {
         const raw = await libreGet('/api/v2/users');
         const users = z.array(UserSchema).parse(raw);
         const trimmed = users.map(({ id, username, first_name, last_name, email, role }) => ({
-            id, username, first_name, last_name, email, role,
+            id,
+            username,
+            first_name,
+            last_name,
+            ...(include_email ? { email } : {}),
+            role,
         }));
         return toolText(trimmed);
     });

package/dist/tools/admin/index.js

@@ -1,6 +1,10 @@
 import { register as registerGetUsers } from './get_users.js';
 import { register as registerGetHosts } from './get_hosts.js';
+import { register as registerCreateShow } from '../shows/create_show.js';
+import { register as registerScheduleFile } from '../shows/schedule_file.js';
 export function register(server) {
     registerGetUsers(server);
     registerGetHosts(server);
+    registerCreateShow(server);
+    registerScheduleFile(server);
 }

package/dist/tools/admin/types.js

@@ -2,13 +2,13 @@ import { z } from 'zod';
 export const UserSchema = z.object({
     id: z.number(),
     username: z.string(),
-    first_name: z.string(),
-    last_name: z.string(),
-    email: z.string(),
-    role: z.string(),
-});
+    first_name: z.string().nullable(),
+    last_name: z.string().nullable(),
+    email: z.string().nullable(),
+    role: z.string().nullable(),
+}).passthrough();
 export const ShowHostSchema = z.object({
     id: z.number(),
     show: z.number(),
     user: z.number(),
-});
+}).passthrough();

package/dist/tools/files/index.js

@@ -1,5 +1,5 @@
 import { register as registerSearchFiles } from './search_files.js';
-import { register as registerUploadFile } from './upload_file.js';
+import { register as registerUploadFile } from './upload_file_legacy.js';
 import { register as registerUpdateFileMetadata } from './update_file_metadata.js';
 import { register as registerDeleteFile } from './delete_file.js';
 export function register(server, uploadUrl, uploadToken) {

package/dist/tools/files/upload_file.js

@@ -1,3 +1,19 @@
+// ON HOLD — waiting on LibreTime to wire the analyzer in the DRF /api/v2/files endpoint.
+//
+// Current behaviour of /api/v2/files (POST):
+//   - Creates a DB record (import_status = 1)
+//   - Does NOT write the file to disk
+//   - Does NOT queue the RabbitMQ analyzer job
+//   - filepath stays null; import_status never transitions to 0
+//
+// The working upload path is in upload_file_legacy.ts (/rest/media, legacy PHP endpoint).
+// index.ts imports from upload_file_legacy.ts until this is resolved upstream.
+//
+// To switch back once the DRF endpoint is fixed:
+//   1. Update index.ts to import from './upload_file.js' instead of './upload_file_legacy.js'
+//   2. Delete upload_file_legacy.ts
+//
+// Upstream context: PLAN.md → Open source contributions → LibreTime file upload
 import { z } from 'zod';
 import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, } from '@modelcontextprotocol/ext-apps/server';
 import fs from 'node:fs/promises';
@@ -5,8 +21,6 @@ import path from 'node:path';
 import { libreGet, libreUpload } from '../../libretime.js';
 import { toolText } from '../../tool-response.js';
 import { LibreFileSchema, LibrarySchema } from './types.js';
-// When running via tsx (dev): __dirname is src/tools/files/ → walk up to project root, then into dist/
-// When running compiled:      __dirname is dist/tools/files/ → walk up two levels to dist/
 const HTML_PATH = import.meta.filename.endsWith('.ts')
     ? path.join(import.meta.dirname, '../../../dist/apps/upload-file.html')
     : path.join(import.meta.dirname, '../../apps/upload-file.html');
@@ -18,79 +32,131 @@ const metadataFields = {
     genre: z.string().optional().describe('Genre'),
     library: z.number().optional().describe('Track type / library ID'),
 };
+const MIME_MAP = {
+    mp3: 'audio/mpeg',
+    flac: 'audio/flac',
+    wav: 'audio/wav',
+    ogg: 'audio/ogg',
+    aac: 'audio/aac',
+    m4a: 'audio/mp4',
+    opus: 'audio/opus',
+};
+function inferMime(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    return MIME_MAP[ext] ?? 'audio/mpeg';
+}
+function appendMetadata(formData, fields) {
+    if (fields.track_title)
+        formData.append('track_title', fields.track_title);
+    if (fields.artist_name)
+        formData.append('artist_name', fields.artist_name);
+    if (fields.album_title)
+        formData.append('album_title', fields.album_title);
+    if (fields.genre)
+        formData.append('genre', fields.genre);
+    if (fields.library)
+        formData.append('library', String(fields.library));
+}
 export function register(server, uploadUrl, uploadToken) {
     registerAppTool(server, 'upload_file', {
-        description: 'Upload an audio file to the LibreTime media library. When no URL is provided, opens a file picker. Optionally pre-fill metadata such as track title, artist, album, and genre.',
+        description: 'Upload an audio file to the LibreTime media library. Provide a URL to fetch the file from, or a local file path when running in stdio mode. When neither is given, opens a file picker. Optionally pre-fill metadata such as track title, artist, album, and genre.',
         inputSchema: {
             url: z.string().optional().describe('Publicly accessible URL of the audio file to upload'),
+            file_path: z.string().optional().describe('Absolute path to a local audio file — use when running stdio mode'),
             ...metadataFields,
         },
         _meta: { ui: { resourceUri } },
-    }, async ({ url, track_title, artist_name, album_title, genre, library }) => {
-        if (!url) {
-            // Fetch track type options for the UI dropdown
-            let libraries = [];
+    }, async ({ url, file_path, track_title, artist_name, album_title, genre, library }) => {
+        const meta = { track_title, artist_name, album_title, genre, library };
+        // Priority 1: local file path (stdio mode — server runs on the user's machine)
+        if (file_path) {
+            let fileBuffer;
             try {
-                const raw = await libreGet('/api/v2/libraries');
-                libraries = LibrarySchema.array().parse(raw);
+                fileBuffer = await fs.readFile(file_path);
             }
-            catch {
-                // Non-fatal — UI will just show no dropdown
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+                });
             }
-            // No URL — hand off to the UI.
-            // If this is the HTTP server, include an upload_url so the UI can POST directly.
-            // If this is stdio, upload_url is null and the UI will ask for a URL instead.
-            return toolText({
-                status: uploadUrl ? 'upload_ready' : 'upload_required',
-                upload_url: uploadUrl ?? null,
-                upload_token: uploadToken ?? null,
-                libraries,
-            });
-        }
-        let fileResponse;
-        try {
-            fileResponse = await fetch(url);
-            if (!fileResponse.ok) {
+            const fileName = path.basename(file_path);
+            const mime = inferMime(file_path);
+            const formData = new FormData();
+            formData.append('file', new Blob([new Uint8Array(fileBuffer)], { type: mime }), fileName);
+            formData.append('name', fileName);
+            formData.append('size', String(fileBuffer.byteLength));
+            formData.append('mime', mime);
+            formData.append('accessed', String(Math.floor(Date.now() / 1000)));
+            appendMetadata(formData, meta);
+            try {
+                const raw = await libreUpload('/api/v2/files', formData);
+                const file = LibreFileSchema.parse(raw);
+                return toolText({ status: 'success', file });
+            }
+            catch (err) {
                 return toolText({
                     status: 'error',
-                    reason: `Could not fetch file: ${fileResponse.status} ${fileResponse.statusText}`,
+                    reason: `LibreTime upload failed: ${err instanceof Error ? err.message : String(err)}`,
                 });
             }
         }
-        catch (err) {
-            return toolText({
-                status: 'error',
-                reason: `Failed to reach URL: ${err instanceof Error ? err.message : String(err)}`,
-            });
+        // Priority 2: remote URL — fetch then forward to LibreTime
+        if (url) {
+            let fileResponse;
+            try {
+                fileResponse = await fetch(url);
+                if (!fileResponse.ok) {
+                    return toolText({
+                        status: 'error',
+                        reason: `Could not fetch file: ${fileResponse.status} ${fileResponse.statusText}`,
+                    });
+                }
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `Failed to reach URL: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+            const fileName = url.split('/').pop()?.split('?')[0] || 'upload';
+            const blob = await fileResponse.blob();
+            const mime = blob.type || inferMime(fileName);
+            const formData = new FormData();
+            formData.append('file', blob, fileName);
+            formData.append('name', fileName);
+            formData.append('size', String(blob.size));
+            formData.append('mime', mime);
+            formData.append('accessed', String(Math.floor(Date.now() / 1000)));
+            appendMetadata(formData, meta);
+            try {
+                const raw = await libreUpload('/api/v2/files', formData);
+                const file = LibreFileSchema.parse(raw);
+                return toolText({ status: 'success', file });
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `LibreTime upload failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
         }
-        const fileName = url.split('/').pop()?.split('?')[0] || 'upload';
-        const blob = await fileResponse.blob();
-        const formData = new FormData();
-        formData.append('file', blob, fileName);
-        if (track_title)
-            formData.append('track_title', track_title);
-        if (artist_name)
-            formData.append('artist_name', artist_name);
-        if (album_title)
-            formData.append('album_title', album_title);
-        if (genre)
-            formData.append('genre', genre);
-        if (library)
-            formData.append('library', String(library));
+        // Priority 3: no input — hand off to the file picker UI
+        let libraries = [];
         try {
-            const raw = await libreUpload('/api/v2/files', formData);
-            const file = LibreFileSchema.parse(raw);
-            return toolText({ status: 'success', file });
+            const raw = await libreGet('/api/v2/libraries');
+            libraries = LibrarySchema.array().parse(raw);
         }
-        catch (err) {
-            return toolText({
-                status: 'error',
-                reason: `LibreTime upload failed: ${err instanceof Error ? err.message : String(err)}`,
-            });
+        catch {
+            // Non-fatal — UI will just show no dropdown
         }
+        return toolText({
+            status: uploadUrl ? 'upload_ready' : 'upload_required',
+            upload_url: uploadUrl ?? null,
+            upload_token: uploadToken ?? null,
+            libraries,
+        });
     });
-    // Serve the bundled React app HTML.
-    // When an upload URL is configured, allow the iframe to connect to it (CSP connect-src).
     registerAppResource(server, resourceUri, resourceUri, { mimeType: RESOURCE_MIME_TYPE }, async () => {
         const html = await fs.readFile(HTML_PATH, 'utf-8');
         return {

package/dist/tools/files/upload_file_legacy.js

@@ -0,0 +1,160 @@
+// Active upload implementation — uses /rest/media (legacy LibreTime PHP endpoint).
+//
+// Background: /api/v2/files (DRF) creates a DB record but never writes to disk or queues
+// the analyzer. /rest/media is the only endpoint that triggers the full import workflow.
+// This file stays active until LibreTime wires the analyzer in the DRF endpoint.
+//
+// When that upstream fix lands, swap index.ts to import from upload_file.ts instead.
+// See upload_file.ts for the DRF implementation kept ready for that switch.
+import { z } from 'zod';
+import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, } from '@modelcontextprotocol/ext-apps/server';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { libreGet, libreRestMedia } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { LibreFileSchema, LibrarySchema } from './types.js';
+// When running via tsx (dev): __dirname is src/tools/files/ → walk up to project root, then into dist/
+// When running compiled:      __dirname is dist/tools/files/ → walk up two levels to dist/
+const HTML_PATH = import.meta.filename.endsWith('.ts')
+    ? path.join(import.meta.dirname, '../../../dist/apps/upload-file.html')
+    : path.join(import.meta.dirname, '../../apps/upload-file.html');
+const resourceUri = 'ui://libretime/upload-file.html';
+const metadataFields = {
+    track_title: z.string().optional().describe('Track title'),
+    artist_name: z.string().optional().describe('Artist name'),
+    album_title: z.string().optional().describe('Album title'),
+    genre: z.string().optional().describe('Genre'),
+    library: z.number().optional().describe('Track type / library ID'),
+};
+const MIME_MAP = {
+    mp3: 'audio/mpeg',
+    flac: 'audio/flac',
+    wav: 'audio/wav',
+    ogg: 'audio/ogg',
+    aac: 'audio/aac',
+    m4a: 'audio/mp4',
+    opus: 'audio/opus',
+};
+function inferMime(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    return MIME_MAP[ext] ?? 'audio/mpeg';
+}
+function appendMetadata(formData, fields) {
+    if (fields.track_title)
+        formData.append('track_title', fields.track_title);
+    if (fields.artist_name)
+        formData.append('artist_name', fields.artist_name);
+    if (fields.album_title)
+        formData.append('album_title', fields.album_title);
+    if (fields.genre)
+        formData.append('genre', fields.genre);
+    if (fields.library)
+        formData.append('library', String(fields.library));
+}
+export function register(server, uploadUrl, uploadToken) {
+    registerAppTool(server, 'upload_file', {
+        description: 'Upload an audio file to the LibreTime media library. Provide a URL to fetch the file from, or a local file path when running in stdio mode. When neither is given, opens a file picker. Optionally pre-fill metadata such as track title, artist, album, and genre.',
+        inputSchema: {
+            url: z.string().optional().describe('Publicly accessible URL of the audio file to upload'),
+            file_path: z.string().optional().describe('Absolute path to a local audio file — use when running stdio mode'),
+            ...metadataFields,
+        },
+        _meta: { ui: { resourceUri } },
+    }, async ({ url, file_path, track_title, artist_name, album_title, genre, library }) => {
+        const meta = { track_title, artist_name, album_title, genre, library };
+        // Priority 1: local file path (stdio mode — server runs on the user's machine)
+        if (file_path) {
+            let fileBuffer;
+            try {
+                fileBuffer = await fs.readFile(file_path);
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+            const fileName = path.basename(file_path);
+            const mime = inferMime(file_path);
+            const formData = new FormData();
+            formData.append('file', new Blob([new Uint8Array(fileBuffer)], { type: mime }), fileName);
+            appendMetadata(formData, meta);
+            try {
+                const raw = await libreRestMedia(formData);
+                const parsed = LibreFileSchema.safeParse(raw);
+                return toolText({ status: 'success', file: parsed.success ? parsed.data : raw });
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `LibreTime upload failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+        // Priority 2: remote URL — fetch then forward to LibreTime
+        if (url) {
+            let fileResponse;
+            try {
+                fileResponse = await fetch(url);
+                if (!fileResponse.ok) {
+                    return toolText({
+                        status: 'error',
+                        reason: `Could not fetch file: ${fileResponse.status} ${fileResponse.statusText}`,
+                    });
+                }
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `Failed to reach URL: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+            const fileName = url.split('/').pop()?.split('?')[0] || 'upload';
+            const blob = await fileResponse.blob();
+            const formData = new FormData();
+            formData.append('file', new Blob([await blob.arrayBuffer()], { type: blob.type || inferMime(fileName) }), fileName);
+            appendMetadata(formData, meta);
+            try {
+                const raw = await libreRestMedia(formData);
+                const parsed = LibreFileSchema.safeParse(raw);
+                return toolText({ status: 'success', file: parsed.success ? parsed.data : raw });
+            }
+            catch (err) {
+                return toolText({
+                    status: 'error',
+                    reason: `LibreTime upload failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+        // Priority 3: no input — hand off to the file picker UI
+        let libraries = [];
+        try {
+            const raw = await libreGet('/api/v2/libraries');
+            libraries = LibrarySchema.array().parse(raw);
+        }
+        catch {
+            // Non-fatal — UI will just show no dropdown
+        }
+        return toolText({
+            status: uploadUrl ? 'upload_ready' : 'upload_required',
+            upload_url: uploadUrl ?? null,
+            upload_token: uploadToken ?? null,
+            libraries,
+        });
+    });
+    registerAppResource(server, resourceUri, resourceUri, { mimeType: RESOURCE_MIME_TYPE }, async () => {
+        const html = await fs.readFile(HTML_PATH, 'utf-8');
+        return {
+            contents: [
+                {
+                    uri: resourceUri,
+                    mimeType: RESOURCE_MIME_TYPE,
+                    text: html,
+                    ...(uploadUrl && {
+                        _meta: { ui: { csp: { connectDomains: [uploadUrl] } } },
+                    }),
+                },
+            ],
+        };
+    });
+}

package/dist/tools/playlists/add_to_playlist.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { librePost } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { PlaylistContentSchema } from './types.js';
+export function register(server) {
+    server.tool('add_to_playlist', 'Add a file or stream to a playlist. Use get_playlist_contents to check the current contents and determine the next position.', {
+        playlist_id: z.number().describe('Playlist ID to add to'),
+        file_id: z.number().optional().describe('File ID to add (use for audio files)'),
+        stream_id: z.number().optional().describe('Stream ID to add (use for webstreams)'),
+        position: z.number().optional().describe('Position in the playlist (0-based). Appends to end if omitted.'),
+    }, async ({ playlist_id, file_id, stream_id, position }) => {
+        if (file_id === undefined && stream_id === undefined) {
+            return toolText({ status: 'error', reason: 'Either file_id or stream_id must be provided.' });
+        }
+        const kind = stream_id !== undefined ? 1 : 0;
+        const raw = await librePost('/api/v2/playlist-contents', {
+            playlist: playlist_id,
+            file: file_id ?? null,
+            stream: stream_id ?? null,
+            kind,
+            position: position ?? null,
+            offset: 0,
+            cue_in: '0:00:00.000000',
+            cue_out: null,
+            fade_in: null,
+            fade_out: null,
+        });
+        const content = PlaylistContentSchema.parse(raw);
+        return toolText({ status: 'added', content });
+    });
+}

package/dist/tools/playlists/create_playlist.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { librePost } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { PlaylistSchema } from './types.js';
+export function register(server) {
+    server.tool('create_playlist', 'Create a new playlist in LibreTime. Returns the playlist ID for use with add_to_playlist.', {
+        name: z.string().describe('Playlist name'),
+        description: z.string().optional().describe('Playlist description'),
+    }, async ({ name, description }) => {
+        const raw = await librePost('/api/v2/playlists', {
+            name,
+            description: description ?? null,
+        });
+        const playlist = PlaylistSchema.parse(raw);
+        return toolText(playlist);
+    });
+}

package/dist/tools/playlists/get_playlist_contents.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { libreGet } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { PlaylistContentSchema } from './types.js';
+export function register(server) {
+    server.tool('get_playlist_contents', 'List the contents of a playlist.', {
+        playlist_id: z.number().describe('Playlist ID'),
+    }, async ({ playlist_id }) => {
+        const raw = await libreGet('/api/v2/playlist-contents', { playlist: String(playlist_id) });
+        const contents = PlaylistContentSchema.array().parse(raw);
+        return toolText(contents);
+    });
+}

package/dist/tools/playlists/get_playlists.js

@@ -0,0 +1,10 @@
+import { libreGet } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { PlaylistSchema } from './types.js';
+export function register(server) {
+    server.tool('get_playlists', 'List all playlists in the LibreTime media library.', {}, async () => {
+        const raw = await libreGet('/api/v2/playlists');
+        const playlists = PlaylistSchema.array().parse(raw);
+        return toolText(playlists);
+    });
+}

package/dist/tools/playlists/index.js

@@ -0,0 +1,10 @@
+import { register as registerGetPlaylists } from './get_playlists.js';
+import { register as registerCreatePlaylist } from './create_playlist.js';
+import { register as registerGetPlaylistContents } from './get_playlist_contents.js';
+import { register as registerAddToPlaylist } from './add_to_playlist.js';
+export function register(server) {
+    registerGetPlaylists(server);
+    registerCreatePlaylist(server);
+    registerGetPlaylistContents(server);
+    registerAddToPlaylist(server);
+}

package/dist/tools/playlists/types.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const PlaylistSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    description: z.string().nullable(),
+    length: z.string().nullable(),
+    owner: z.number().nullable(),
+    created_at: z.string().nullable(),
+    updated_at: z.string().nullable(),
+}).passthrough();
+export const PlaylistContentSchema = z.object({
+    id: z.number(),
+    kind: z.number().describe('0=File, 1=Stream, 2=Block'),
+    position: z.number().nullable(),
+    offset: z.number(),
+    length: z.string().nullable(),
+    cue_in: z.string().nullable(),
+    cue_out: z.string().nullable(),
+    fade_in: z.string().nullable(),
+    fade_out: z.string().nullable(),
+    playlist: z.number().nullable(),
+    file: z.number().nullable(),
+    stream: z.number().nullable(),
+}).passthrough();

package/dist/tools/shows/create_show.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { librePost } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { ShowSchema } from './types.js';
+export function register(server) {
+    server.tool('create_show', 'Create a new show in LibreTime. Returns the created show with its ID, which can be used to schedule instances.', {
+        name: z.string().describe('Show name'),
+        description: z.string().optional().describe('Show description'),
+        genre: z.string().optional().describe('Genre'),
+        url: z.string().optional().describe('Show website URL'),
+    }, async ({ name, description, genre, url }) => {
+        const raw = await librePost('/api/v2/shows', {
+            name,
+            description: description ?? null,
+            genre: genre ?? null,
+            url: url ?? null,
+            linked: false,
+            linkable: false,
+            auto_playlist_enabled: false,
+            auto_playlist_repeat: false,
+            override_intro_playlist: false,
+            override_outro_playlist: false,
+        });
+        const show = ShowSchema.parse(raw);
+        return toolText(show);
+    });
+}

package/dist/tools/shows/get_show.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { libreGet } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { ShowSchema } from './types.js';
+export function register(server) {
+    server.tool('get_show', 'Get details of a single LibreTime show by ID.', { id: z.number().describe('Show ID') }, async ({ id }) => {
+        const raw = await libreGet(`/api/v2/shows/${id}`);
+        const show = ShowSchema.parse(raw);
+        return toolText(show);
+    });
+}

package/dist/tools/shows/get_show_instances.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { libreGet } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { ShowInstanceSchema } from './types.js';
+export function register(server) {
+    server.tool('get_show_instances', 'List scheduled instances of a show. Optionally filter by show ID or date range.', {
+        show_id: z.number().optional().describe('Filter by show ID'),
+        starts_after: z.string().optional().describe('ISO 8601 datetime — only return instances starting after this time'),
+        starts_before: z.string().optional().describe('ISO 8601 datetime — only return instances starting before this time'),
+    }, async ({ show_id, starts_after, starts_before }) => {
+        const params = {};
+        if (show_id !== undefined)
+            params.show = String(show_id);
+        if (starts_after)
+            params.starts_after = starts_after;
+        if (starts_before)
+            params.starts_before = starts_before;
+        const raw = await libreGet('/api/v2/show-instances', params);
+        const instances = ShowInstanceSchema.array().parse(raw);
+        return toolText(instances);
+    });
+}

package/dist/tools/shows/get_station_info.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { libreGet } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+const InfoSchema = z.object({
+    station_name: z.string(),
+}).passthrough();
+export function register(server) {
+    server.tool('get_station_info', 'Get basic station information such as the station name.', {}, async () => {
+        const raw = await libreGet('/api/v2/info');
+        const info = InfoSchema.parse(raw);
+        return toolText(info);
+    });
+}

package/dist/tools/shows/index.js

@@ -1,8 +1,14 @@
 import { register as registerGetShows } from './get_shows.js';
+import { register as registerGetShow } from './get_show.js';
+import { register as registerGetShowInstances } from './get_show_instances.js';
 import { register as registerGetSchedule } from './get_schedule.js';
 import { register as registerGetStreamState } from './get_stream_state.js';
+import { register as registerGetStationInfo } from './get_station_info.js';
 export function register(server) {
     registerGetShows(server);
+    registerGetShow(server);
+    registerGetShowInstances(server);
     registerGetSchedule(server);
     registerGetStreamState(server);
+    registerGetStationInfo(server);
 }

package/dist/tools/shows/schedule_file.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { libreGet, librePost } from '../../libretime.js';
+import { toolText } from '../../tool-response.js';
+import { ScheduleItemSchema } from './types.js';
+import { LibreFileSchema } from '../files/types.js';
+// LibreTime duration format: "H:MM:SS.ffffff" → milliseconds
+function parseDurationMs(length) {
+    if (!length)
+        return null;
+    const match = length.match(/^(\d+):(\d{2}):(\d{2})\.(\d+)$/);
+    if (!match)
+        return null;
+    const [, h, m, s, frac] = match;
+    const ms = Math.round(parseInt(frac.padEnd(3, '0').slice(0, 3)));
+    return (parseInt(h) * 3600 + parseInt(m) * 60 + parseInt(s)) * 1000 + ms;
+}
+export function register(server) {
+    server.tool('schedule_file', 'Schedule an uploaded file into a show instance at a specific time. ' +
+        'Fetches the file duration automatically to calculate the end time. ' +
+        'Use get_show_instances to find the instance ID for the show slot you want to fill.', {
+        instance_id: z.number().describe('Show instance ID to schedule into'),
+        file_id: z.number().describe('ID of the uploaded file to schedule'),
+        starts_at: z.string().describe('ISO 8601 datetime for when the file should start playing'),
+        position: z.number().optional().describe('Position in the show queue (defaults to 0)'),
+    }, async ({ instance_id, file_id, starts_at, position = 0 }) => {
+        // Fetch file to get duration for ends_at / cue_out calculation
+        const fileRaw = await libreGet(`/api/v2/files/${file_id}`);
+        const file = LibreFileSchema.passthrough().parse(fileRaw);
+        const length = file.length;
+        const durationMs = parseDurationMs(length);
+        if (!durationMs) {
+            return toolText({
+                status: 'error',
+                reason: `Could not determine file duration (length: ${length ?? 'null'}). ` +
+                    'The file may still be processing — check import_status and try again.',
+            });
+        }
+        const startsDate = new Date(starts_at);
+        const endsDate = new Date(startsDate.getTime() + durationMs);
+        const ends_at = endsDate.toISOString();
+        const cue_out = length;
+        const raw = await librePost('/api/v2/schedule', {
+            instance: instance_id,
+            file: file_id,
+            starts_at,
+            ends_at,
+            cue_in: '0:00:00.000000',
+            cue_out,
+            position,
+            position_status: 0,
+            broadcasted: 0,
+        });
+        const item = ScheduleItemSchema.parse(raw);
+        return toolText({ status: 'scheduled', item });
+    });
+}

package/dist/tools/shows/types.js

@@ -2,10 +2,27 @@ import { z } from 'zod';
 export const ShowSchema = z.object({
     id: z.number(),
     name: z.string(),
-    description: z.string(),
-    genre: z.string(),
-    url: z.string(),
-});
+    description: z.string().nullable(),
+    genre: z.string().nullable(),
+    url: z.string().nullable(),
+    linked: z.boolean().optional(),
+    linkable: z.boolean().optional(),
+    auto_playlist_enabled: z.boolean().optional(),
+    auto_playlist_repeat: z.boolean().optional(),
+    override_intro_playlist: z.boolean().optional(),
+    override_outro_playlist: z.boolean().optional(),
+}).passthrough();
+export const ShowInstanceSchema = z.object({
+    id: z.number(),
+    starts_at: z.string(),
+    ends_at: z.string(),
+    filled_time: z.string().nullable(),
+    description: z.string().nullable(),
+    modified: z.boolean(),
+    auto_playlist_built: z.boolean(),
+    show: z.number(),
+    instance: z.number().nullable(),
+}).passthrough();
 export const ScheduleItemSchema = z.object({
     id: z.number(),
     starts_at: z.string(),
@@ -13,7 +30,7 @@ export const ScheduleItemSchema = z.object({
     instance: z.number(),
     file: z.number().nullable(),
     broadcasted: z.number(),
-    played: z.boolean(),
+    played: z.boolean().nullable(),
 }).passthrough();
 export const StreamStateSchema = z.object({
     input_main_connected: z.boolean(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerfm/libretime-mcp",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "license": "GPL-3.0",