shipLua () } local function hidePopup() popup.Visible = false for _, child in popup:GetChildren() do if child:IsA("GuiObject") then child:Destroy() end end end local function showPopup(items: { PopupItem }, heading: string?) hidePopup() if #items == 0 then return end if heading then local title = Instance.new("TextLabel") title.BackgroundTransparency = 1 title.Size = UDim2.fromScale(1, 0) title.AutomaticSize = Enum.AutomaticSize.Y title.TextXAlignment = Enum.TextXAlignment.Left title.Text = heading title.TextSize = Ui.SMALL title.FontFace = Ui.FONT title.TextColor3 = Ui.C.fg2 title.LayoutOrder = 0 title.ZIndex = 41 Ui.padding(title, 8, 2, 8, 2) title.Parent = popup end for index, item in items do local row = Instance.new("TextButton") row.LayoutOrder = index row.Size = UDim2.fromScale(1, 0) row.AutomaticSize = Enum.AutomaticSize.Y row.BackgroundColor3 = Ui.C.button row.BackgroundTransparency = 1 row.AutoButtonColor = false row.Text = "" row.ZIndex = 41 Ui.corner(row, 4) Ui.padding(row, 8, 4) Ui.hlist(row, 6) row.MouseEnter:Connect(function() row.BackgroundTransparency = 0 end) row.MouseLeave:Connect(function() row.BackgroundTransparency = 1 end) local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.Size = UDim2.fromOffset(0, 18) label.TextXAlignment = Enum.TextXAlignment.Left label.TextTruncate = Enum.TextTruncate.AtEnd label.RichText = true label.TextSize = Ui.SMALL label.FontFace = Ui.FONT label.TextColor3 = Ui.C.fg local detail = if item.detail then " " .. item.detail .. "" else "" label.Text = "" .. item.label .. "" .. detail label.LayoutOrder = 1 label.ZIndex = 42 label.Parent = row Ui.fill(label) if item.current then local check = Ui.icon(row, Ui.ICONS.Chosen, Ui.SMALL, Ui.C.brand) check.LayoutOrder = 2 check.ZIndex = 42 end row.Activated:Connect(function() hidePopup() item.pick() end) row.Parent = popup end placePopup() popup.Visible = true end -- Escapes text that goes into a RichText label. local function plainText(text: string): string return (string.gsub(string.gsub(string.gsub(text, "&", "&"), "<", "<"), ">", ">")) end -- Claudio's send button: filled in the main colour once there is something to send, otherwise -- an outlined circle. local function paintSend() local ready = string.find(inputBox.Text, "%S") ~= nil sendButton.BackgroundColor3 = Ui.C.brand sendButton.BackgroundTransparency = if ready then 0 else 1 sendButton.TextColor3 = if ready then Ui.C.onBrand else Ui.C.fg2 sendStroke.Color = Ui.C.line sendStroke.Transparency = if ready then 1 else 0 end -- Colours of the parts that live across redraws; called on start and when the theme changes. local function paintChrome() root.BackgroundColor3 = Ui.C.bg topBar.BackgroundColor3 = Ui.C.surface body.BackgroundColor3 = Ui.C.bg body.ScrollBarImageColor3 = Ui.C.line contextLine.TextColor3 = Ui.C.fg2 placeAction.TextColor3 = Ui.C.brand inputBar.BackgroundColor3 = Ui.C.surface inputField.BackgroundColor3 = Ui.C.input inputBox.TextColor3 = Ui.C.fg inputBox.PlaceholderColor3 = Ui.C.fg2 paintSend() popup.BackgroundColor3 = Ui.C.input local stroke = popup:FindFirstChild("Stroke") :: UIStroke? if stroke then stroke.Color = Ui.C.button end hidePopup() end paintChrome() inputBox:GetPropertyChangedSignal("Text"):Connect(paintSend) -- Shows the status bar and input bar only when signed in; signed out the messages fill the panel. local function layoutChrome(chat: boolean) topBar.Visible = chat contextBar.Visible = chat inputBar.Visible = chat if not chat then hidePopup() end end -- ───────────── State ───────────── type Link = { org: { id: string, name: string }, project: { id: string, name: string }, user: { displayName: string }, role: string, canAudit: boolean, canAsk: boolean, canReview: boolean?, dashboardUrl: string, } local link: Link? = nil local view = "loading" -- loading | signedOut | pairing | home | offline -- While offline: why, and when the next try is (os.clock()). local offline = { message = "", retryAt = 0, tries = 0 } local tab = "home" -- home | check | ask | fix | grow | agent | assistant | settings | help local lastQuestion: string? = nil local growTab = "funnels" -- funnels | tests local busy = false local status: string? = nil local errorText: string? = nil local pairingCode: string? = nil local pairingUrl: string? = nil local pairingSerial = 0 local report: any = nil local scriptsByPath: { [string]: LuaSourceContainer } = {} local answer: any = nil local review: any = nil local reviewSerial = 0 -- Sending scripts to the AI is opt-in and remembered per Studio install. local SETTING_AI_REVIEW = "ShipLuaAiReview" local aiReview = plugin:GetSetting(SETTING_AI_REVIEW) == true -- AI fix suggestions: the problems to pick from, the current run, and what happened to each edit. local fixSignals: any = nil local fixAvailable = true local fixLoading = false local fix: any = nil local fixSerial = 0 local fixScripts: { [string]: LuaSourceContainer } = {} local fixConfirm: number? = nil local fixNotes: { [number]: string } = {} type Update = { version: string, windows: string?, mac: string? } local update: Update? = nil local render: () -> () local function setError(message: string?) errorText = message render() end -- ───────────── Updates ───────────── local function versionParts(value: string): { number } local parts = {} for part in string.gmatch(value, "%d+") do table.insert(parts, tonumber(part) :: number) end return parts end local function isNewer(remote: string, current: string): boolean local a, b = versionParts(remote), versionParts(current) for index = 1, math.max(#a, #b) do local x, y = a[index] or 0, b[index] or 0 if x ~= y then return x > y end end return false end -- Studio sessions run for days: look again every few hours, not only when the plugin loads. local UPDATE_CHECK_SECONDS = 4 * 60 * 60 local SETTING_UPDATE_DISMISSED = "ShipLuaUpdateDismissed" local function checkForUpdate() local latest = Api.getJson(string.gsub(Config.siteBase, "/+$", "") .. "/studio/version") if type(latest) ~= "table" or type(latest.version) ~= "string" then return end if not isNewer(latest.version, Config.version) or (update and update.version == latest.version) then return end -- A dismissed version stays dismissed, also after Studio restarts. if plugin:GetSetting(SETTING_UPDATE_DISMISSED) == latest.version then return end local install = if type(latest.install) == "table" then latest.install else {} update = { version = latest.version, windows = if type(install.windows) == "string" then install.windows else nil, mac = if type(install.mac) == "string" then install.mac else nil, } render() end local function renderUpdate() local current = update :: Update local card = Ui.card(body, Ui.C.brand) Ui.text(card, "Update available: shipLua " .. current.version, { bold = true }) -- Plugins cannot open a browser, so the download page is a link to copy. Ui.text(card, "You have " .. Config.version .. ". Copy this link to download the new plugin:", { size = 12, dim = true }) Ui.copyable(card, string.gsub(Config.siteBase, "/+$", "") .. "/download#download", true) Ui.text(card, "Studio updates by itself only plugins installed from the Creator Store. If you installed from a file, replace ShipLua.rbxmx in your Plugins folder (or run the command below), then restart Studio: close every Studio window and open it again.", { size = 11, dim = true }) if current.windows then Ui.text(card, "Windows (PowerShell)", { size = 11, dim = true }) Ui.copyable(card, current.windows, true) Ui.text(card, "Windows Security blocked the install? This can be a false positive. Keep Windows Security enabled. Check Protection history for the detection name, update security definitions, and retry the official download. If it is still blocked, stop and contact shipLua support with the detection name.", { size = 12, dim = true }) end if current.mac then Ui.text(card, "macOS (Terminal)", { size = 11, dim = true }) Ui.copyable(card, current.mac, true) end Ui.button(card, "Dismiss", function() plugin:SetSetting(SETTING_UPDATE_DISMISSED, current.version) update = nil render() end) end -- ───────────── Open place ───────────── -- What the server says about the place open in Studio: linked, another experience, waiting to be -- added on the website, or unpublished. Reporting only suggests; a person adds it on the website. local placeStatus: any = nil local function reportPlace() local response = api:request("POST", "/studio/place", { placeId = math.max(game.PlaceId, 0), universeId = math.max(game.GameId, 0), placeName = string.sub(game.Name, 1, 100), }) if response.ok and type(response.body) == "table" then placeStatus = response.body if placeStatus.status == "switched" then -- The server moved this Studio to the open place's experience; pick up the new link. local me = api:request("GET", "/studio/me") if me.ok and type(me.body) == "table" then link = me.body.link end end render() end end -- What the context line's "Add ›" opens: one short card. Plugins cannot open a browser, so the -- page is a link to copy. Reporting only suggests; a person adds the game on the website. local placeOpen = false local function renderPlaceStatus() local current = placeStatus if not placeOpen or type(current) ~= "table" then return end local card = Ui.card(body) local canAdd = link ~= nil and (link.role == "OWNER" or link.role == "ADMIN") if current.status == "proposed" then if canAdd then Ui.text(card, "Add this game to shipLua", { medium = true }) Ui.text(card, "It's waiting in Games on the website. Copy the link, open it and press Add.", { size = 12, dim = true }) else Ui.text(card, "Ask an owner to add this game", { medium = true }) Ui.text(card, "It's waiting in Games on the website. Send them this link:", { size = 12, dim = true }) end Ui.copyable(card, current.reviewUrl or "") elseif current.status == "other_experience" and type(current.project) == "table" then Ui.text(card, "This place belongs to " .. tostring(current.project.name), { medium = true }) Ui.text(card, "Checks from here still go to " .. (link and link.project.name or "the connected experience") .. ". Turn on auto-switch in shipLua Settings, Studio tab, or sign out and connect again.", { size = 12, dim = true }) elseif current.status == "unpublished" then Ui.text(card, "This place isn't published yet", { medium = true }) Ui.text(card, "Publish it once (File, Publish to Roblox) and shipLua can add it as its own experience.", { size = 12, dim = true }) else card:Destroy() end end -- ───────────── Sign in ───────────── -- No answer, or the server itself failing (Render restarting, a deploy): the token is still -- good, so wait and try again instead of signing the person out. local function unreachable(response: any): boolean return response.status == 0 or response.status >= 500 end local function goOffline(message: string) offline.tries += 1 offline.message = message -- 5 s, 10 s, 20 s, then every 30 s. offline.retryAt = os.clock() + math.min(5 * 2 ^ (offline.tries - 1), 30) view = "offline" render() end local function checkSignedIn() if not token then view = "signedOut" render() return end if view ~= "home" and view ~= "offline" then view = "loading" render() end local response = api:request("GET", "/studio/me") if response.ok then local first = view ~= "home" local before = if link then HttpService:JSONEncode(link) else nil link = response.body.link offline.tries = 0 if first then view = "home" errorText = nil task.spawn(reportPlace) elseif before == HttpService:JSONEncode(link) then -- Nothing changed: leave the panel alone so a half-typed field keeps its text. return end elseif response.status == 401 then saveToken(nil) link = nil view = "signedOut" errorText = response.message elseif unreachable(response) then goOffline(response.message) return else errorText = response.message end render() end local function startPairing() errorText = nil busy = true render() local placeId = if game.PlaceId > 0 then game.PlaceId else nil local response = api:request("POST", "/studio/pairings", { placeName = string.sub(game.Name, 1, 100), placeId = placeId, -- Lets the website offer this game as a new experience, or pick the one that has it. universeId = if game.GameId > 0 then game.GameId else nil, pluginVersion = Config.version, }) busy = false if not response.ok then setError(response.message) return end pairingCode = response.body.userCode pairingUrl = response.body.verifyUrl view = "pairing" render() pairingSerial += 1 local serial = pairingSerial local deviceCode = response.body.deviceCode local interval = math.max(response.body.intervalSeconds or POLL_SECONDS, 2) local deadline = os.clock() + (response.body.expiresInSeconds or 600) task.spawn(function() while serial == pairingSerial and os.clock() < deadline do task.wait(interval) if serial ~= pairingSerial then return end local claim = api:request("POST", "/studio/pairings/claim", { deviceCode = deviceCode }) if claim.ok and claim.body then local state = claim.body.status if state == "approved" then saveToken(claim.body.token) link = claim.body.link view = "home" pairingCode = nil render() task.spawn(reportPlace) return elseif state == "denied" or state == "expired" then view = "signedOut" pairingCode = nil setError(if state == "denied" then "The code was declined on the website." else "The code expired. Start again.") return end end end if serial == pairingSerial and view == "pairing" then view = "signedOut" pairingCode = nil setError("The code expired. Start again.") end end) end local function signOut() api:request("DELETE", "/studio/me") saveToken(nil) link = nil placeStatus = nil report = nil review = nil reviewSerial += 1 answer = nil fixSignals = nil fix = nil fixSerial += 1 view = "signedOut" render() end -- ───────────── Check scripts ───────────── -- Polls the AI review of one check until it ends; a newer check stops the old poll. local function watchReview(runId: string) reviewSerial += 1 local serial = reviewSerial review = { status = "QUEUED" } render() for _ = 1, 72 do task.wait(5) if serial ~= reviewSerial then return end local response = api:request("GET", "/studio/audits/" .. runId .. "/ai-review") if serial ~= reviewSerial then return end if response.ok and response.body and response.body.review then review = response.body.review render() if review.status ~= "QUEUED" and review.status ~= "RUNNING" then return end elseif not response.ok and response.status ~= 0 then review = { status = "FAILED", errorMessage = response.message } render() return end end review = { status = "FAILED", errorMessage = "The AI review is taking long. See it on the dashboard later." } render() end local function runAudit() if busy then return end busy = true errorText = nil status = "Reading scripts…" render() local snapshot = Snapshot.collect() if snapshot.error or not snapshot.json then busy = false status = nil setError(snapshot.error) return end scriptsByPath = snapshot.byPath status = "Checking " .. snapshot.scriptCount .. " scripts…" review = nil reviewSerial += 1 render() local wantsReview = aiReview and link ~= nil and link.canReview == true local path = if wantsReview then "/studio/audits?aiReview=1" else "/studio/audits" local response = api:request("POST", path, snapshot.json, true) busy = false status = nil if response.status == 401 then saveToken(nil) view = "signedOut" setError(response.message) return end if not response.ok then setError(response.message) return end report = response.body render() if wantsReview and report and report.run then task.spawn(watchReview, report.run.id) end end local function openFinding(finding: any) local path = finding.scriptPath local target = if type(path) == "string" then scriptsByPath[path] or fixScripts[path] else nil if not target then setError("That script is not in the open place any more. Run the check again.") return end local line = if type(finding.line) == "number" then finding.line else 1 -- A proposal carries the exact code it replaces: select all of it, not just the first line. local _, span = Highlight.lineOf(Changes.readSource(target), finding.find) task.spawn(Highlight.show, plugin, target, line, span) end -- ───────────── Ask ───────────── local TASKS = { { id = "UPDATE_PLAN", label = "Plan my next update" }, { id = "FEEDBACK_THEMES", label = "What are players saying?" }, { id = "MONETIZATION_REVIEW", label = "How can it earn more, fairly?" }, { id = "RETENTION_IDEAS", label = "How do I keep players coming back?" }, { id = "PLAYER_NOTES", label = "Write update notes for players" }, } local function ask(taskId: string, question: string?) if busy then return end busy = true errorText = nil answer = nil status = "Thinking… this can take a minute." render() local payload: { [string]: any } = { task = taskId } if question and question ~= "" then payload.question = question end local started = api:request("POST", "/studio/assistant/runs", payload) if not started.ok then busy = false status = nil setError(started.message) return end local runId = started.body.run.id local deadline = os.clock() + 300 while os.clock() < deadline do task.wait(2) local polled = api:request("GET", "/studio/assistant/runs/" .. runId) if not polled.ok then busy = false status = nil setError(polled.message) return end local run = polled.body.run if run.status == "SUCCEEDED" and run.output then busy = false status = nil answer = run render() return elseif run.status == "SUCCEEDED" or run.status == "FAILED" or run.status == "CANCELLED" then busy = false status = nil setError(run.errorMessage or "The assistant could not answer this time. Try again.") return end end busy = false status = nil setError("The answer is taking longer than usual. It will appear on the website when it is ready.") end -- ───────────── Fix problems ───────────── -- Counts plain (not pattern) matches of `needle`, stopping at two. Returns the first position. local function findOnce(text: string, needle: string): (number, number?) local count, first, from = 0, nil, 1 for _ = 1, 2 do local at = string.find(text, needle, from, true) if not at then break end count += 1 first = first or at from = at + 1 end return count, first end local function loadFixSignals() if fixLoading then return end fixLoading = true errorText = nil render() local response = api:request("GET", "/studio/fix-signals") fixLoading = false if not response.ok then -- An empty list stops the panel from asking again on every redraw; Refresh retries. fixSignals = {} setError(response.message) return end fixSignals = response.body.items or {} fixAvailable = response.body.available ~= false render() end -- Polls one run until it ends; asking again stops the old poll. local function watchFix(fixId: string) fixSerial += 1 local serial = fixSerial for _ = 1, 72 do task.wait(5) if serial ~= fixSerial then return end local response = api:request("GET", "/studio/fixes/" .. fixId) if serial ~= fixSerial then return end if response.ok and response.body and response.body.fix then fix = response.body.fix render() if fix.status ~= "QUEUED" and fix.status ~= "RUNNING" then return end elseif not response.ok and response.status ~= 0 then fix = { status = "FAILED", errorMessage = response.message, proposals = {} } render() return end end fix = { status = "FAILED", errorMessage = "The suggestions are taking long. Try again in a few minutes.", proposals = {} } render() end local function requestFix(signal: any) if busy then return end busy = true errorText = nil fix = nil -- Stops the poll of an earlier run from showing it again. fixSerial += 1 fixConfirm = nil fixNotes = {} status = "Reading scripts…" render() local snapshot = Snapshot.collect() if snapshot.error or not snapshot.json then busy = false status = nil setError(snapshot.error) return end fixScripts = snapshot.byPath status = "Sending scripts related to this problem…" render() local query = "/studio/fixes?signalId=" .. HttpService:UrlEncode(signal.id) local response = api:request("POST", query, snapshot.json, true) busy = false status = nil if response.status == 401 then saveToken(nil) view = "signedOut" setError(response.message) return end if not response.ok then setError(response.message) return end fix = response.body.fix render() if fix.status == "QUEUED" or fix.status == "RUNNING" then task.spawn(watchFix, fix.id) end end local function reportDecision(proposal: any, decision: string) if not fix or not fix.id then return end local response = api:request("POST", "/studio/fixes/" .. fix.id .. "/proposals/" .. proposal.index .. "/decision", { decision = decision, }) if response.ok and response.body and response.body.fix then fix = response.body.fix render() end end -- Applies one edit, only after the person pressed Apply and then confirmed. The text to replace -- must still occur exactly once in the live script, so an edit never lands in the wrong place. -- The change is one undo step (Ctrl+Z). local function applyProposal(proposal: any): (boolean, string) local target = fixScripts[proposal.scriptPath] if not target or not target.Parent then return false, "That script is not in the open place any more. Ask for suggestions again." end local read, current = pcall(function() return ScriptEditorService:GetEditorSource(target) end) if not read or type(current) ~= "string" then current = (target :: any).Source end local count = findOnce(current, proposal.find) if count ~= 1 then return false, if count == 0 then "The script changed since the suggestion, so the code to replace is not there any more. Nothing was changed." else "The code to replace appears more than once now. Nothing was changed; edit it by hand." end local before = (target :: any).Source local recording = ChangeHistoryService:TryBeginRecording("ShipLuaFix", "shipLua fix: " .. proposal.title) local done, problem = pcall(function() ScriptEditorService:UpdateSourceAsync(target, function(old: string): string? local matches, at = findOnce(old, proposal.find) if matches ~= 1 or not at then return nil end return string.sub(old, 1, at - 1) .. proposal.replace .. string.sub(old, at + #proposal.find) end) end) local after = (target :: any).Source local applied = done and type(after) == "string" and after ~= before if recording then ChangeHistoryService:FinishRecording( recording, if applied then Enum.FinishRecordingOperation.Commit else Enum.FinishRecordingOperation.Cancel ) end if not applied then return false, "Studio did not take the edit" .. (if problem then " (" .. tostring(problem) .. ")" else "") .. ". Nothing was changed." end return true, "Applied. Press Ctrl+Z to undo, then test the place before you publish." end -- ───────────── Funnels, A/B tests and your AI tool ───────────── -- Tells shipLua the place changed, so its dashboard refreshes for anyone looking at it. local function reportActivity(kind: string, count: number) if link then api:request("POST", "/studio/activity", { kind = kind, count = count }) end end local function currentApi() return api end local funnels = Funnels.new({ api = currentApi, render = function() render() end, siteBase = Config.siteBase, report = reportActivity, }) local SETTING_AGENTS_SEEN = "shiplua.agentsSeen" local agentTeam = AgentTeam.new({ api = currentApi, render = function() render() end, pageUrl = function() local dashboard = link and link.dashboardUrl local base = dashboard and string.match(dashboard, "^(.-/app/[^/]+)") return if base then base .. "/agents" else nil end, seen = function() local saved = plugin:GetSetting(SETTING_AGENTS_SEEN) return if type(saved) == "table" then saved else {} end, setSeen = function(seen) plugin:SetSetting(SETTING_AGENTS_SEEN, seen) end, }) local tests = Tests.new({ api = currentApi, render = function() render() end, }) local agent: any = nil local agentHandlers = funnels:handlers() agentHandlers.list_instances = PlaceTools.listInstances agentHandlers.get_properties = PlaceTools.getProperties agentHandlers.read_source = PlaceTools.readSource agentHandlers.find = PlaceTools.find agentHandlers.logs = PlaceTools.logs agentHandlers.playtest = PlaceTools.playtest agentHandlers.lint = function() if not link then error("Sign the shipLua plugin in first: press Sign in in the shipLua panel.") end local snapshot = Snapshot.collect() if snapshot.error or not snapshot.json then error(snapshot.error or "The place could not be read.") end scriptsByPath = snapshot.byPath local response = api:request("POST", "/studio/audits", snapshot.json, true) if not response.ok then error(response.message) end report = response.body task.defer(render) local findings = {} for _, finding in response.body.findings or {} do table.insert(findings, { severity = finding.severity, title = finding.title, description = finding.description, fix = if finding.recommendation then finding.recommendation.summary else nil, scriptPath = finding.scriptPath, line = finding.line, }) end return { scriptsChecked = snapshot.scriptCount, findings = findings } end agentHandlers.sdk_install = function(args) local files, problem = Sdk.fetch(Config.siteBase) if not files then error(problem) end return agent:submit({ summary = "Add or update the shipLua SDK " .. files.version, changes = Sdk.changes(files), forceApproval = true, activity = "sdk_installed", waitMs = args.waitMs, }) end local guide = Guide.new({ api = currentApi, render = function() render() end, open = function(target: string) tab = "grow" growTab = if target == "tests" then "tests" else "funnels" errorText = nil render() end, }) agentHandlers.setup_guide = function() if not link then error("Sign the shipLua plugin in first: press Sign in in the shipLua panel. That is step 1, connecting the game.") end local data, problem = guide:fetch() if not data then error(problem) end return data end agentHandlers.diagnose_game = function(args) if not link then error("Sign the shipLua plugin in first: press Sign in in the shipLua panel.") end local payload: { [string]: any } = { question = string.sub(tostring(args.question or ""), 1, 500) } if type(args.focus) == "string" and args.focus ~= "" then payload.focus = args.focus end local response = api:request("POST", "/studio/diagnose", payload) if not response.ok then error(response.message) end return response.body end agentHandlers.search_knowledge = function(args) if not link then error("Sign the shipLua plugin in first: press Sign in in the shipLua panel.") end local payload: { [string]: any } = {} for _, field in { "query", "domain", "genre", "metric" } do if type(args[field]) == "string" and args[field] ~= "" then payload[field] = args[field] end end if type(args.limit) == "number" then payload.limit = math.clamp(math.floor(args.limit), 1, 15) end local response = api:request("POST", "/studio/knowledge", payload) if not response.ok then error(response.message) end return response.body end agentHandlers.draft_ab_test = function(args) local created, problem = tests:draft({ name = tostring(args.name or ""), key = if type(args.key) == "string" then args.key else nil, control = tostring(args.control or ""), test = tostring(args.test or ""), metric = if type(args.metric) == "string" then args.metric else nil, }) if not created then error(problem) end return { status = "draft", name = created.experiment.name, startItHere = created.dashboardUrl, codeToAdd = created.snippet } end agent = Agent.new({ plugin = plugin, render = function() render() end, report = reportActivity, handlers = agentHandlers, -- A change is waiting: bring the panel up on the Agent tab. onWaiting = function() -- The change shows as a permission card at the end of the chat. if tab == "agent" then tab = if #assistant.messages > 0 then "assistant" else "home" end widget.Enabled = true end, info = function() return { version = Config.version, place = { name = string.sub(game.Name, 1, 100), placeId = math.max(game.PlaceId, 0), gameId = math.max(game.GameId, 0) }, signedIn = link ~= nil, project = if link then link.project.name else nil, } end, }) -- The built-in assistant (your own Claude key): the same tools as an outside AI tool, plus the -- guided setup. Everything it changes goes through the approval queue above. local function objectSchema(properties: { [string]: any }?, required: { string }?): { [string]: any } local schema: { [string]: any } = { type = "object" } if properties then schema.properties = properties end if required then schema.required = required end return schema end local function call(name: string) return function(input: { [string]: any }) return agentHandlers[name](input) end end local assistantTools: { [string]: any } = { list_instances = { description = "Children of an instance (full name with dots, e.g. ServerScriptService); omit path for the services. depth 1-3.", schema = objectSchema({ path = { type = "string" }, depth = { type = "integer" } }), run = call("list_instances"), }, get_properties = { description = "Common properties and attributes of one instance.", schema = objectSchema({ path = { type = "string" } }, { "path" }), run = call("get_properties"), }, read_source = { description = "A script's source with line numbers, optionally a line range.", schema = objectSchema({ path = { type = "string" }, startLine = { type = "integer" }, endLine = { type = "integer" } }, { "path" }), run = call("read_source"), }, find_in_place = { description = "Find text in script sources (in = source) or instance names (in = names).", schema = objectSchema({ query = { type = "string" }, ["in"] = { type = "string", enum = { "source", "names" } }, limit = { type = "integer" } }, { "query" }), run = call("find"), }, get_output_log = { description = "Recent lines of the Studio Output window.", schema = objectSchema({ limit = { type = "integer" } }), run = call("logs"), }, lint_place = { description = "shipLua's code review of the place's scripts; findings most serious first.", schema = objectSchema(), run = call("lint"), }, propose_changes = { description = "Propose ALL changes of this reply as one batch. Ops: edit_script {path, find, replace} (find occurs once), set_source {path, source}, insert_after {path, anchor, text}, prepend {path, text}, create_script {parentPath, name, className, source}, create_instance {parentPath, name, className}, set_property {path, property, value}, delete_instance {path}. The person sees a diff and approves; returns the status.", schema = objectSchema({ summary = { type = "string" }, changes = { type = "array", items = { type = "object" } }, }, { "summary", "changes" }), run = function(input) return agent:submit({ summary = input.summary, changes = input.changes, waitMs = 45000 }) end, }, diagnose_game = { description = "Start here for any why or is-it-working question about this game (players dropping or not coming back, a shop that does not sell, whether an update worked, who plays). Runs the analyses that answer it on the game this panel is signed in to (its numbers against their bars, odd days, the last update's before/after, similar public games for outside causes such as a bigger competitor, the audience mix) and returns readings with the arithmetic, likely causes and next steps (an A/B test sized for this game's traffic, a remote config change, a funnel, a code fix here in Studio, or questions for the team). Read-only. Follow its howToAnswer. Causes are guidance, not proof.", schema = objectSchema({ question = { type = "string" }, focus = { type = "string" } }, { "question" }), run = call("diagnose_game"), }, search_knowledge = { description = "The Roblox knowledge base: what a professional Roblox game analyst knows, as short sourced entries (player psychology, onboarding, progression, retention, LiveOps, monetization, economy, discovery and the algorithm, why numbers move such as a competitor launch, genre trend, season, outage or a bad update, audience shifts, performance, A/B tests, Roblox rules, genre notes). Search by words; optional domain, genre or metric filters. Use it for why-did-players-drop, is-our-audience-shifting and what-should-we-try questions, then check this game before concluding. Entries are general guidance: cite their sources, treat verifyFirst items as possibly out of date, and suggest only ideas that fit this game.", schema = objectSchema({ query = { type = "string" }, domain = { type = "string" }, genre = { type = "string" }, metric = { type = "string" }, limit = { type = "integer" }, }), run = call("search_knowledge"), }, setup_guide = { description = "The guided setup for this game: connect, plan, SDK, funnels, A/B test, each with a status and a sentence to say before acting.", schema = objectSchema(), run = call("setup_guide"), }, install_sdk = { description = "Install or update the shipLua SDK in ServerScriptService. The person approves the change in the panel.", schema = objectSchema(), run = call("sdk_install"), }, plan_funnel_setup = { description = "Read the place and propose the starter funnel steps, where each is counted, and warnings. Show the steps and ask which to keep.", schema = objectSchema(), run = function() local plan, problem = funnels:fetchPlan() if not plan then error(problem) end funnels.plan = plan funnels.choices = {} local steps = {} for _, step in plan.steps do funnels.choices[step.key] = { enabled = true, label = nil, placement = 1 } local where = step.placements[1] table.insert(steps, { key = step.key, label = step.label, alreadyTracked = step.alreadyTracked, where = if where then where.label .. (if where.scriptPath then " (" .. where.scriptPath .. ")" else "") else "no safe spot found: the person pastes one line", }) end local warnings = {} for _, warning in plan.warnings do table.insert(warnings, warning.message) end return { steps = steps, sdk = plan.sdk.state, warnings = warnings, purchaseFix = plan.purchaseFix ~= nil } end, }, apply_funnel_setup = { description = "After the person agreed: propose the tracking code for the kept steps (skip lists step keys to leave out) as one change they approve in the panel.", schema = objectSchema({ skip = { type = "array", items = { type = "string" } }, includePurchaseFix = { type = "boolean" } }), run = function(input) if not funnels.plan then error("Call plan_funnel_setup first.") end for _, key in (if type(input.skip) == "table" then input.skip else {}) do if funnels.choices[key] then funnels.choices[key].enabled = false end end funnels.includeFix = input.includePurchaseFix ~= false return agent:submit({ summary = "Add funnel tracking", changes = funnels:selectedChanges(), forceApproval = true, activity = "funnel_code_applied", waitMs = 45000, }) end, }, save_funnel = { description = "Save the kept funnel steps on the shipLua dashboard (after the code is applied).", schema = objectSchema(), run = function() if not funnels.plan then error("Call plan_funnel_setup first.") end local saved, problem = funnels:save(funnels:keptSteps(), nil) if not saved then error(problem) end return saved end, }, draft_ab_test = { description = "Draft an A/B test of one value (e.g. starting coins): name, control (today's value), test (value to try), optional metric d1_retention | playtime_per_user | payer_conversion | d7_retention. It stays a draft until the person starts it themselves, in the Grow tab or on the website.", schema = objectSchema({ name = { type = "string" }, control = { type = "string" }, test = { type = "string" }, metric = { type = "string" }, }, { "name", "control", "test" }), run = call("draft_ab_test"), }, } -- What the assistant knows at the start of a chat: the place, the shipLua link, the SDK, scripts. local function gatherContext(): string local lines = { "Place: " .. game.Name .. " (placeId " .. game.PlaceId .. ", universeId " .. game.GameId .. (if game.PlaceId > 0 then ")" else ", not published)"), "shipLua: " .. (if link then "signed in, experience " .. link.project.name else "not signed in"), } local _, sdkVersion = Sdk.find() table.insert(lines, "shipLua SDK: " .. (sdkVersion or "not installed")) local snapshot = Snapshot.collect() local paths = {} for path in snapshot.byPath do table.insert(paths, path) end table.sort(paths) table.insert(lines, "Scripts (" .. #paths .. "):") for index, path in paths do if index > 150 then table.insert(lines, "… " .. (#paths - 150) .. " more; use find_in_place.") break end local item = snapshot.byPath[path] local _, newlines = string.gsub((item :: any).Source, "\n", "") table.insert(lines, "- " .. path .. " (" .. item.ClassName .. ", " .. (newlines + 1) .. " lines)") end return table.concat(lines, "\n") end local assistant = Assistant.new({ plugin = plugin, render = function() render() end, tools = assistantTools, gather = gatherContext, }) local tour = Tour.new(plugin, function() render() end) -- Install help (requirements and troubleshooting), opened from "Install help". local helpOpen = false local function openHelp() helpOpen = true render() end -- ───────────── Views ───────────── local function header(parent: Instance) Ui.header(parent, "shipLua") end local function renderSignedOut() header(body) Ui.text(body, "Sign in to shipLua", { bold = true, size = 15 }) Ui.text(body, "Check your scripts for bugs that lose data or money, set up funnels and A/B tests, and let your agents and AI tools work in this place with your approval.", { dim = true }) -- The same sign-in as the shipLua CLI: a short code you confirm on the website. local steps = Ui.card(body) Ui.step(steps, "1. Press Sign in. You get a short code.") Ui.step(steps, "2. Open the link it shows and check it's you.") Ui.step(steps, "3. Come back here. The panel signs in on its own.") Ui.button(body, if busy then "Starting…" else "Sign in", function() if not busy then startPairing() end end, { primary = true }) Ui.text(body, "No password goes through Studio, and shipLua never asks for your Roblox cookie.", { size = 12, dim = true }) local advanced = Ui.list(body, 4) Ui.text(advanced, "Server", { size = 12, dim = true }) local box = Ui.input(advanced, Config.apiBase) box.Text = server() box.FocusLost:Connect(function() local value = string.gsub(box.Text, "%s", "") if value == "" or value == Config.apiBase then plugin:SetSetting(SETTING_SERVER, "") else plugin:SetSetting(SETTING_SERVER, value) end api = Api.new(server(), function() return token end) end) -- Reading the place and approving changes from your AI tool works without signing in. agent:render(body, Config.siteBase) Ui.button(body, "Take the tour", function() tour:start() end) Ui.button(body, "Install help", openHelp) end local offlineCountdown: TextLabel? = nil local function renderOffline() header(body) local card = Ui.card(body, Ui.C.warn) Ui.text(card, "Can't reach shipLua servers", { bold = true, color = Ui.C.warn }) Ui.text(card, offline.message, { size = 12, dim = true }) offlineCountdown = Ui.text(card, "", { size = 12, dim = true }) Ui.text(card, if link then "You're still signed in. Nothing you do here is sent until shipLua is back." else "You're still signed in.", { size = 12, dim = true }) Ui.button(body, "Retry now", function() offline.retryAt = 0 end, { primary = true }) end local function renderPairing() header(body) Ui.text(body, "Open this page in your browser:", { dim = true }) Ui.copyable(body, pairingUrl or "", true) Ui.text(body, "and enter this code:", { dim = true }) local code = Ui.text(body, pairingCode or "", { size = 28, bold = true, mono = true, color = Ui.C.accent }) code.TextXAlignment = Enum.TextXAlignment.Center Ui.text(body, "Waiting for you to approve it… This panel updates on its own.", { size = 12, dim = true }) Ui.button(body, "Cancel", function() pairingSerial += 1 pairingCode = nil view = "signedOut" render() end) end local function renderReport(parent: Instance) local run = report.run local findings = report.findings or {} local scanned = if run.source then run.source.scriptCount else 0 -- As in the mockup: tool lines for what was read, then one card with the problems. Ui.step(parent, "Read " .. scanned .. (if scanned == 1 then " script" else " scripts")) Ui.step(parent, run.findingsOpened .. " new · " .. run.findingsResolved .. " fixed since last check") local summary = Ui.card(parent) if #findings == 0 then Ui.text(summary, "No problems found", { medium = true, color = Ui.C.ok }) else Ui.text(summary, #findings .. (if #findings == 1 then " problem to fix" else " problems to fix"), { medium = true }) for index, finding in findings do if index > 6 then Ui.text(summary, "and " .. (#findings - 6) .. " more below", { size = 12, dim = true }) break end local line = Ui.row(summary) Ui.badge(line, finding.severity, Ui.SEVERITY_COLORS[finding.severity]) local title = Ui.text(line, finding.title, { size = 12 }) title.Size = UDim2.new(1, -80, 0, 0) end end Ui.text(parent, "Read-only: nothing in the place was changed", { size = 12, dim = true }) if #findings > 0 then Ui.section(parent, "What to fix", "Most serious first. Open a script to jump to the line.") end for _, finding in findings do local card = Ui.card(parent, Ui.SEVERITY_COLORS[finding.severity]) Ui.badge(card, finding.severity, Ui.SEVERITY_COLORS[finding.severity]) Ui.text(card, finding.title, { bold = true }) Ui.text(card, finding.description, { size = 13 }) if finding.recommendation and finding.recommendation.summary then Ui.text(card, "Fix: " .. finding.recommendation.summary, { size = 13, dim = true }) end if finding.scriptPath then local where = finding.scriptPath .. (if finding.line then ":" .. finding.line else "") Ui.button(card, "Open " .. where, function() openFinding(finding) end) end end if review then Ui.section(parent, "AI review") local head = Ui.card(parent, Ui.C.brand) if review.status == "QUEUED" or review.status == "RUNNING" then Ui.progress(head, "Reading the riskiest scripts. This usually takes a minute or two.") elseif review.status == "FAILED" then Ui.notice(parent, "error", review.errorMessage or "The AI review failed.") else if review.summary then Ui.text(head, review.summary, { size = 13 }) end if review.isMock then Ui.text(head, "Demo review: no AI provider is connected on the server.", { size = 12, dim = true }) end Ui.text(head, "Suggestions to check, not proof.", { size = 12, dim = true }) for _, item in review.findings or {} do local severity = string.upper(item.severity) local card = Ui.card(parent, Ui.SEVERITY_COLORS[severity]) local tags = Ui.row(card) Ui.badge(tags, severity, Ui.SEVERITY_COLORS[severity]) if item.confidence == "low" then Ui.badge(tags, "Unsure") end Ui.text(card, item.title, { bold = true }) Ui.text(card, item.explanation, { size = 13 }) Ui.text(card, "Fix: " .. item.fix, { size = 13, dim = true }) Ui.button(card, "Open " .. item.scriptPath .. ":" .. item.line, function() openFinding(item) end) end end end end local function renderAnswer(parent: Instance) local output = answer.output local top = Ui.card(parent, Ui.C.brand) Ui.text(top, output.headline, { bold = true, size = 15 }) Ui.text(top, output.summary, { size = 13 }) if answer.isMock then Ui.text(top, "Demo answer: no AI provider is connected on the server.", { size = 12, dim = true }) end for _, section in output.sections do Ui.section(parent, section.heading) for index, item in section.items do local card = Ui.card(parent) Ui.text(card, index .. ". " .. item.title, { bold = true, size = 14 }) Ui.text(card, item.detail, { size = 13 }) Ui.text(card, "Why: " .. item.why, { size = 12, dim = true }) end end if output.playerMessage then Ui.section(parent, "Message for players", "Copy it into your game’s announcement or group post.") local box = Ui.copyable(parent, output.playerMessage) box.MultiLine = true box.TextWrapped = true box.AutomaticSize = Enum.AutomaticSize.Y end if #output.dataGaps > 0 then Ui.notice(parent, "info", "Would answer better with: " .. table.concat(output.dataGaps, " ")) end Ui.text(parent, "Suggestions only. Nothing in your game was changed.", { size = 11, dim = true }) end local function codeBox(parent: Instance, text: string) local box = Ui.copyable(parent, text, true) box.MultiLine = true box.TextWrapped = true box.TextSize = 12 box.AutomaticSize = Enum.AutomaticSize.Y end -- A suggested fix as Claudio's permission card: the tool line, the edit as a diff, then Allow -- (one undo step) or Deny. local function renderProposal(parent: Instance, proposal: any) local severity = if proposal.confidence == "high" then "HIGH" elseif proposal.confidence == "medium" then "MEDIUM" else "LOW" Ui.step(parent, "Edit " .. proposal.scriptPath .. ":" .. proposal.line) local note = fixNotes[proposal.index] local function diffLines(card: Instance) local lines = {} for text in string.gmatch(proposal.find .. "\n", "(.-)\n") do table.insert(lines, { kind = "-", text = text }) end for text in string.gmatch(proposal.replace .. "\n", "(.-)\n") do table.insert(lines, { kind = "+", text = text }) end Ui.diff(card, lines) end if proposal.decision == "applied" or proposal.decision == "dismissed" then local card = Ui.card(parent) local head = Ui.row(card) Ui.badge(head, if proposal.decision == "applied" then "Applied" else "Denied", if proposal.decision == "applied" then Ui.C.ok else nil) local title = Ui.text(head, proposal.title, { medium = true }) title.Size = UDim2.new(1, -90, 0, 0) if note then Ui.text(card, note, { size = 12, dim = true }) end return end local card = Ui.permission(parent, { title = proposal.title, allowLabel = "Allow", onAllow = function() local applied, message = applyProposal(proposal) fixNotes[proposal.index] = message render() if applied then task.spawn(reportDecision, proposal, "applied") end end, onDeny = function() task.spawn(reportDecision, proposal, "dismissed") end, }) local tags = Ui.row(card) Ui.badge(tags, proposal.confidence .. " confidence", Ui.SEVERITY_COLORS[severity]) Ui.text(card, proposal.why, { size = 12, dim = true }) diffLines(card) if note then Ui.notice(card, "warning", note) end Ui.button(card, "Show line", function() openFinding(proposal) end, { small = true }) end local function renderFixes(current: Link) Ui.text(body, "Pick a crash or metric drop shipLua measured. The AI reads the scripts most related to it and suggests edits. Nothing changes until you press Apply and confirm.", { size = 12, dim = true }) if not current.canReview then Ui.text(body, "Your role cannot send scripts to the AI. Ask an owner, admin or developer.", { dim = true }) return end if fixSignals == nil then if fixLoading then Ui.progress(body, "Loading problems…") end if not fixLoading then -- Deferred: loading redraws the panel, which must not happen in the middle of a draw. task.defer(loadFixSignals) end return end if not fixAvailable then Ui.text(body, "AI fix suggestions are not set up on this shipLua server.", { dim = true }) return end if #fixSignals == 0 then Ui.empty(body, "Nothing to fix right now", "No crash or metric drop. Connect Roblox analytics on the website to measure them, or check back after your next release.") end for _, signal in fixSignals do local severity = string.upper(signal.severity) local card = Ui.card(body, Ui.SEVERITY_COLORS[severity]) Ui.badge(card, severity, Ui.SEVERITY_COLORS[severity]) Ui.text(card, signal.title, { bold = true }) Ui.text(card, signal.detail, { size = 13 }) if signal.isMock then Ui.text(card, "Demo data: this experience uses the demo Roblox connection.", { size = 12, dim = true }) end Ui.button(card, if busy then "Working…" else "Suggest a fix", function() task.spawn(requestFix, signal) end, { primary = true }) end Ui.button(body, "Refresh problems", function() fixSignals = nil render() end) Ui.text(body, "Suggest a fix sends the scripts most related to that problem to Claude with secrets masked. They are kept encrypted until the run ends, then erased.", { size = 11, dim = true }) if status then if busy then Ui.progress(body, status) else Ui.text(body, status, { dim = true }) end end if not fix then return end Ui.section(body, "Suggested fixes", if fix.signal then "For: " .. fix.signal.title else nil) if fix.status == "QUEUED" or fix.status == "RUNNING" then Ui.progress(body, "Reading the related scripts. This usually takes a minute or two.") return elseif fix.status == "FAILED" then Ui.notice(body, "error", fix.errorMessage or "The suggestions failed.") return end local head = Ui.card(body, Ui.C.brand) if fix.summary then Ui.text(head, fix.summary, { size = 13 }) end if fix.isMock then Ui.text(head, "Demo suggestions: no AI provider is connected on the server.", { size = 12, dim = true }) end Ui.text(head, "Suggestions to check, not proof the edit fixes the problem.", { size = 12, dim = true }) if #fix.proposals == 0 then Ui.empty(body, "No edit to suggest", "The AI found nothing it could safely change in these scripts.") end for _, proposal in fix.proposals do renderProposal(body, proposal) end end local function openFunnels() tab = "grow" growTab = "funnels" errorText = nil render() end -- What each command and starter chip opens. "home" is the welcome message only. local SECTIONS: { [string]: string } = { home = "", check = "Check this place", fix = "Fix problems", grow = "Set up funnels", tests = "Draft an A/B test", ask = "Ask about my game", assistant = "", agent = "Agents and AI tools", settings = "Settings", help = "Commands", } local COMMANDS = { { name = "/check", tab = "check", detail = "Check this place for bugs that lose data or money" }, { name = "/fix", tab = "fix", detail = "Fix a crash or metric drop shipLua measured" }, { name = "/funnels", tab = "grow", detail = "Set up funnels" }, { name = "/abtest", tab = "tests", detail = "Draft an A/B test" }, { name = "/ask", tab = "ask", detail = "Plan an update, read feedback, earn more" }, { name = "/agents", tab = "agent", detail = "Your AI tools and changes waiting for you" }, { name = "/settings", tab = "settings", detail = "Your key, AI review, sign out" }, { name = "/help", tab = "help", detail = "This list" }, } local function open(section: string) if section == "tests" then tab = "grow" growTab = "tests" elseif section == "grow" then tab = "grow" growTab = "funnels" else tab = section end errorText = nil render() end -- What the person typed in the input bar: a /command, or a question for the assistant. local function submit(raw: string) local text = string.gsub(raw, "^%s+", "") text = string.gsub(text, "%s+$", "") if text == "" then return end if string.sub(text, 1, 1) ~= "/" and (if assistant.key ~= "" then assistant.busy else busy) then -- Still answering the last message: keep what they typed so they can send it after. setError("Still working on your last message. Send this one when it finishes.") return end inputBox.Text = "" errorText = nil if string.sub(text, 1, 1) == "/" then local name = string.lower(string.match(text, "^(/%S+)") or text) for _, command in COMMANDS do if command.name == name then open(command.tab) return end end open("help") return end local current = link if not current then return end if assistant.key ~= "" then tab = "assistant" render() task.spawn(function() assistant:send(text) end) elseif string.find(string.lower(text), "funnel", 1, true) then -- Funnels are set up here, not described: open the setup flow. openFunnels() elseif current.canAsk and #text >= 3 then tab = "ask" lastQuestion = text render() task.spawn(ask, "QUESTION", text) else errorText = "Your role cannot ask the assistant. Ask an owner or admin." render() end end -- Typing "/" opens the matching commands above the input bar, as in Claudio and the CLI. inputBox:GetPropertyChangedSignal("Text"):Connect(function() local text = inputBox.Text if string.sub(text, 1, 1) ~= "/" or string.find(text, "%s") then if popup.Visible then hidePopup() end return end local typed = string.lower(text) local items: { PopupItem } = {} for _, command in COMMANDS do if string.sub(command.name, 1, #typed) == typed then table.insert(items, { label = command.name, detail = plainText(command.detail), pick = function() inputBox.Text = "" open(command.tab) end, }) end end showPopup(items) end) inputBox.FocusLost:Connect(function(enterPressed) if enterPressed then hidePopup() submit(inputBox.Text) end end) sendButton.Activated:Connect(function() submit(inputBox.Text) end) -- "claude-sonnet-5-5" → "Sonnet 5.5", as in the CLI. local function modelLabel(id: string): string local family, major, minor = string.match(id, "^claude%-(%a+)%-(%d+)%-?(%d*)") if not family then return id end return string.upper(string.sub(family, 1, 1)) .. string.sub(family, 2) .. " " .. major .. (if minor ~= "" then "." .. minor else "") end -- The approval mode, in the words of the mockup. local MODE_WORDS: { [string]: string } = { manual = "Ask before edits", accept_edits = "Accept edits", plan = "Plan only", auto = "Auto", } local function showModels() local items: { PopupItem } = {} for _, model in Assistant.MODELS do table.insert(items, { label = modelLabel(model.id), detail = plainText(model.detail), current = model.id == assistant.model, pick = function() assistant:save(assistant.key, model.id, assistant.effort) end, }) end showPopup(items, "Model") end local function showModes() local items: { PopupItem } = {} for _, mode in Agent.MODES do table.insert(items, { label = MODE_WORDS[mode.id] or mode.label, detail = plainText(mode.detail), current = mode.id == agent.mode, pick = function() agent:setMode(mode.id) end, }) end showPopup(items, "When your AI tool changes something") end local function showCommands() local items: { PopupItem } = {} for _, command in COMMANDS do table.insert(items, { label = command.name, detail = plainText(command.detail), pick = function() inputBox.Text = "" open(command.tab) end, }) end showPopup(items, "Commands") end -- Whether the open place needs a word in the context line. local function renderPlaceLine(current: Link) local status = if type(placeStatus) == "table" then placeStatus.status else nil local canAdd = current.role == "OWNER" or current.role == "ADMIN" local words = nil if status == "proposed" then words = if canAdd then "Not in shipLua yet · Add ›" else "Not in shipLua yet · Ask an owner ›" elseif status == "other_experience" then words = "Another game ›" elseif status == "unpublished" then words = "Not published ›" end placeAction.Visible = words ~= nil placeAction.Text = words or "" if not words then placeOpen = false end end placeAction.Activated:Connect(function() placeOpen = not placeOpen render() end) -- Under the input box (Claudio's Tools row): +, the approval mode, then the model and the usage -- ring on the right. The model and ring show with your own key; on shipLua's AI the server picks. local function renderTools() Ui.clear(toolsRow) local add = Ui.iconButton(toolsRow, Ui.ICONS.Add, function() if popup.Visible then hidePopup() else showCommands() end end) add.LayoutOrder = 1 local mode = Ui.pill(toolsRow, MODE_WORDS[agent.mode] or agent.mode, function() if popup.Visible then hidePopup() else showModes() end end, true) mode.LayoutOrder = 2 local spacer = Instance.new("Frame") spacer.BackgroundTransparency = 1 spacer.Size = UDim2.new() spacer.LayoutOrder = 3 spacer.Parent = toolsRow Ui.fill(spacer) if assistant.key ~= "" then local model = Ui.pill(toolsRow, modelLabel(assistant.model), function() if popup.Visible then hidePopup() else showModels() end end) model.LayoutOrder = 4 local share = math.clamp(assistant.usage.context / assistant:window(), 0, 1) local ring = Ui.usageRing(toolsRow, share) ring.LayoutOrder = 5 ring.Activated:Connect(function() setError("This chat uses " .. math.floor(share * 100 + 0.5) .. "% of " .. modelLabel(assistant.model) .. "'s context. Press New to start fresh.") end) else local label = Ui.text(toolsRow, "shipLua AI", { size = 12, dim = true }) label.AutomaticSize = Enum.AutomaticSize.XY label.Size = UDim2.new() label.TextWrapped = false label.LayoutOrder = 4 end end -- The chat's title, as in Claudio: its first message. local function chatTitle(): string for _, entry in assistant.entries do if entry.kind == "user" then return entry.text end end return "Chat" end -- Claudio's StatusBar: Agents (Back while a page is open), the chat's title, settings, New. local function renderTopBar(current: Link) Ui.clear(topBar) local paged = tab == "agent" or tab == "settings" local agents = Ui.button(topBar, if paged then "Back" else "Agents", function() open(if paged then (if #assistant.messages > 0 then "assistant" else "home") else "agent") end) agents.LayoutOrder = 1 -- Something waits for you (a change to approve, or new lines from an Agent): a small dot. local waiting = agent:waiting() + agentTeam:unreadCount() if waiting > 0 and not paged then local dot = Instance.new("Frame") dot.AnchorPoint = Vector2.new(0.5, 0.5) dot.Position = UDim2.new(1, 7, 0, -2) dot.Size = UDim2.fromOffset(7, 7) dot.BackgroundColor3 = Ui.C.brand dot.BorderSizePixel = 0 dot.ZIndex = 3 Ui.corner(dot, 4) dot.Parent = agents end local title = Instance.new("TextLabel") title.Name = "Title" title.BackgroundTransparency = 1 title.Size = UDim2.fromScale(0, 0) title.AutomaticSize = Enum.AutomaticSize.Y title.TextXAlignment = Enum.TextXAlignment.Left title.TextTruncate = Enum.TextTruncate.AtEnd title.TextSize = Ui.TEXT title.FontFace = Ui.MEDIUM title.TextColor3 = Ui.C.fg title.Text = if tab == "agent" then "Agents" elseif SECTIONS[tab] and SECTIONS[tab] ~= "" then SECTIONS[tab] elseif tab == "assistant" then chatTitle() else "New chat" title.LayoutOrder = 2 title.Parent = topBar Ui.fill(title) local gear = Ui.iconButton(topBar, Ui.ICONS.Settings, function() open(if tab == "settings" then "home" else "settings") end, { active = tab == "settings" }) gear.LayoutOrder = 3 local newButton = Ui.button(topBar, "New", function() if not assistant.busy then assistant:reset() end agent.allowChat = false answer = nil lastQuestion = nil open("home") end, { primary = true }) newButton.LayoutOrder = 4 contextLine.Text = "Game · " .. current.project.name renderPlaceLine(current) renderTools() end -- The first message of a new chat (the mockup's greeting), with the starters under it. local function welcome(current: Link) local reply = Ui.list(body, 8) Ui.text(reply, "Hi " .. current.user.displayName .. ". I can check this place, fix what I find, and set up funnels and A/B tests. What should we do?") local chips = Ui.chips(reply) for _, item in { { "Check this place", "check" }, { "Fix problems", "fix" }, { "Set up funnels", "grow" }, { "Draft an A/B test", "tests" }, { "Ask about my game", "ask" } } do Ui.chip(chips, item[1], function() open(item[2]) end) end end local function renderCheck(current: Link) if not current.canAudit then Ui.text(body, "Your role can view results but not run checks. Ask an owner or admin.", { dim = true }) return end if not report and not busy then Ui.text(body, "I read the scripts and remotes in the open place. Nothing is changed, and the source is not kept after the check.", { size = 13 }) Ui.button(body, "Check this place", runAudit, { primary = true, width = 140 }) end if status then if busy then Ui.progress(body, status) else Ui.step(body, status) end end if report then renderReport(body) Ui.button(body, "Check again", runAudit, { width = 110 }) end end local function renderAsk(current: Link) if not current.canAsk then Ui.text(body, "Your role cannot ask the assistant. Ask an owner or admin.", { dim = true }) return end if not answer and not busy then Ui.text(body, "Ask anything below, or pick one:", { size = 13 }) local chips = Ui.chips(body) for _, item in TASKS do Ui.chip(chips, item.label, function() lastQuestion = item.label task.spawn(ask, item.id) end) end end if status then if busy then Ui.progress(body, status) else Ui.step(body, status) end end if answer then renderAnswer(body) end Ui.text(body, "For a full update plan with the best time to ship, open Update plans for this game on the shipLua website.", { size = 11, dim = true }) end local function renderSettings(current: Link) assistant:renderSettings(body) -- Your own AI tool (Claude Code, Codex, Cursor) through the shipLua CLI, and its history. agent:render(body, Config.siteBase) if current.canReview then local card = Ui.card(body) Ui.text(card, "AI review of scripts", { bold = true }) Ui.text(card, "When on, a check also sends the riskiest server scripts to Claude with secrets masked, kept encrypted until the review ends, then erased.", { size = 12, dim = true }) Ui.button(card, if aiReview then "AI review: on" else "AI review: off", function() aiReview = not aiReview plugin:SetSetting(SETTING_AI_REVIEW, aiReview) render() end, { primary = aiReview, width = 120 }) end local card = Ui.card(body) Ui.text(card, "Full history, team and settings", { bold = true }) Ui.copyable(card, current.dashboardUrl) local actions = Ui.row(card) Ui.button(actions, "Take the tour", function() tour:start() end, { width = 110 }) Ui.button(actions, "Install help", openHelp, { width = 110 }) Ui.button(actions, "Sign out of this Studio", signOut, { width = 170, danger = true }) end local function renderHelp() Ui.text(body, "Type one of these in the box below:", { size = 13 }) local card = Ui.card(body) for _, command in COMMANDS do local row = Ui.row(card) local name = Ui.text(row, command.name, { mono = true, size = 12, color = Ui.C.accent }) name.Size = UDim2.new(0, 80, 0, 0) local detail = Ui.text(row, command.detail, { size = 12 }) detail.Size = UDim2.new(1, -90, 0, 0) end -- What the shipLua CLI needs, and fixes for what usually goes wrong. Ui.button(body, "Install help", openHelp) end local renderSection: (current: Link) -> () local function renderHome() local current = link :: Link renderTopBar(current) renderPlaceStatus() renderSection(current) -- Changes from your AI tool wait at the end of the chat, as Claudio's permission card. if tab ~= "agent" and tab ~= "settings" then agent:renderWaiting(body) end end renderSection = function(current: Link) if tab == "home" then welcome(current) return end -- The command or chip that opened this section, shown as the person's own message. local said = if tab == "ask" and lastQuestion then lastQuestion elseif tab == "grow" and growTab == "tests" then SECTIONS.tests else SECTIONS[tab] if said and said ~= "" and tab ~= "settings" and tab ~= "agent" and tab ~= "help" then Ui.bubble(body, "user", said) end if tab == "check" then renderCheck(current) elseif tab == "fix" then renderFixes(current) elseif tab == "grow" then guide:render(body) if growTab == "tests" then tests:render(body) else funnels:render(body) end elseif tab == "agent" then agentTeam:render(body) elseif tab == "assistant" then assistant:render(body, true) elseif tab == "settings" then renderSettings(current) elseif tab == "help" then renderHelp() else renderAsk(current) end end render = function() Ui.clear(body) layoutChrome(view == "home" and link ~= nil and not tour.open) if update then renderUpdate() end if tour.open then header(body) tour:draw(body) return end if helpOpen then header(body) Help.draw(body, Config.siteBase, function() helpOpen = false render() end) return end if errorText then Ui.notice(body, "error", errorText) end if view == "loading" then header(body) Ui.progress(body, "Connecting to shipLua servers…") elseif view == "offline" then renderOffline() elseif view == "signedOut" then renderSignedOut() elseif view == "pairing" then renderPairing() elseif link then renderHome() end end render() -- Light or dark: follow the Studio theme, like Studio's own panels. local themeConnection = Ui.onThemeChanged(function() paintChrome() render() end) local unloading = false plugin.Unloading:Connect(function() unloading = true if themeConnection then themeConnection:Disconnect() end end) task.spawn(checkSignedIn) -- Keeping up with the dashboard. A plugin cannot be sent a message, so it keeps one request -- open (GET /studio/live) that the server answers the moment something changes, such as an -- Agent edited or removed on the website, then asks again. A check every 15 s backs it up -- (another server instance, a lost answer), and clicking into the panel reads at once. local SYNC_SECONDS = 15 local lastSync = 0 local function sync() if unloading or not link or view ~= "home" then return end lastSync = os.clock() checkSignedIn() if view == "home" then agentTeam:load() end end task.spawn(function() while not unloading do task.wait(1) if view == "offline" then local left = math.max(0, math.ceil(offline.retryAt - os.clock())) if offlineCountdown and offlineCountdown.Parent then offlineCountdown.Text = if left > 0 then "Trying again in " .. left .. "s…" else "Trying again…" end if left == 0 then checkSignedIn() end elseif widget.Enabled and os.clock() - lastSync >= SYNC_SECONDS then sync() end end end) task.spawn(function() while not unloading do if not link or view ~= "home" or not widget.Enabled then task.wait(2) continue end local response = api:request("GET", "/studio/live") if unloading then break end if response.ok then for _, event in (response.body and response.body.events) or {} do if event.kind == "agents" then agentTeam:load() end end elseif response.status == 401 or unreachable(response) then -- checkSignedIn decides between signed out and offline. sync() task.wait(5) else task.wait(SYNC_SECONDS) end end end) local lastFocus = 0 widget.WindowFocused:Connect(function() if os.clock() - lastFocus > 3 then lastFocus = os.clock() task.spawn(sync) end end) task.spawn(function() while true do checkForUpdate() task.wait(UPDATE_CHECK_SECONDS) end end) ]]>ConfigApi string?) local self = setmetatable({}, Api) self.baseUrl = string.gsub(baseUrl, "/+$", "") self.getToken = getToken return self end local function messageFrom(status: number, body: any): string if type(body) == "table" and type(body.error) == "table" and type(body.error.message) == "string" then return body.error.message end if type(body) == "table" and type(body.message) == "string" then return body.message end if status == 0 then return "shipLua could not be reached. Check your internet connection and that Studio may use HTTP for this plugin." end return "shipLua answered with an error (" .. tostring(status) .. ")." end -- method: "GET" | "POST" | "DELETE". `raw` sends the body as a gzip-compressed octet stream. function Api:request(method: string, path: string, body: any?, raw: boolean?): Response local headers: { [string]: string } = { Accept = "application/json" } local token = self.getToken() if token then headers.Authorization = "Bearer " .. token -- Lets the dashboard show which plugin version each Studio runs. headers["x-shiplua-plugin"] = Config.version end local options: { [string]: any } = { Url = self.baseUrl .. "/v1" .. path, Method = method, Headers = headers, } if body ~= nil then if raw then headers["Content-Type"] = "application/octet-stream" options.Body = body options.Compress = Enum.HttpCompression.Gzip else headers["Content-Type"] = "application/json" options.Body = HttpService:JSONEncode(body) end end local sent, result = pcall(function() return HttpService:RequestAsync(options) end) if not sent then local text = tostring(result) if string.find(text, "Http requests", 1, true) or string.find(text, "permission", 1, true) then return { ok = false, status = 0, body = nil, message = "Allow HTTP requests for the shipLua plugin when Studio asks, then try again." } end return { ok = false, status = 0, body = nil, message = messageFrom(0, nil) } end local decoded: any = nil if result.Body and #result.Body > 0 then local parsed, value = pcall(function() return HttpService:JSONDecode(result.Body) end) if parsed then decoded = value end end local ok = result.StatusCode >= 200 and result.StatusCode < 300 return { ok = ok, status = result.StatusCode, body = decoded, message = if ok then "" else messageFrom(result.StatusCode, decoded), } end -- Reads a public JSON document outside the API, such as the site's latest plugin version. function Api.getJson(url: string): any? local sent, result = pcall(function() return HttpService:RequestAsync({ Url = url, Method = "GET", Headers = { Accept = "application/json" } }) end) if not sent or result.StatusCode ~= 200 then return nil end local parsed, value = pcall(function() return HttpService:JSONDecode(result.Body) end) return if parsed then value else nil end return Api ]]>SnapshotUi= 4.5 then return blended end end return full end -- Claudio's sizes: body text 14, small text 12. Ui.TEXT = 14 Ui.SMALL = 12 local function fontOf(name: string, fallback: Enum.Font): Font local ok, face = pcall(function() return Font.fromEnum((Enum.Font :: any)[name]) end) return if ok and face then face else Font.fromEnum(fallback) end Ui.FONT = fontOf("BuilderSans", Enum.Font.Gotham) Ui.MEDIUM = fontOf("BuilderSansMedium", Enum.Font.GothamMedium) Ui.BOLD = fontOf("BuilderSansBold", Enum.Font.GothamBold) Ui.MONO = Font.fromEnum(Enum.Font.Code) -- Studio's built-in icon font. A name such as "gear" draws that icon (Claudio's Config.IconFont). Ui.ICON_FONT = Font.new("rbxasset://LuaPackages/Packages/_Index/BuilderIcons/BuilderIcons/BuilderIcons.json", Enum.FontWeight.Regular) Ui.ICONS = { Add = "plus-large", Settings = "gear", Close = "x", Down = "chevron-small-down", Right = "chevron-small-right", Chosen = "check", Copy = "two-stacked-squares", Retry = "arrow-clockwise", Send = "arrow-large-up", Stop = "stop-small", Back = "arrow-large-left", More = "three-dots-horizontal", Warning = "triangle-exclamation", } -- shipLua's brand blue, kept for the small mark only. Ui.BRAND = rgb(0x2F5BFF) Ui.C = {} :: { [string]: Color3 } local C = Ui.C -- Fills Ui.C from the current Studio theme, with the same mapping as Claudio's Theme.Guide. -- Callers read Ui.C.* while drawing, so a redraw after this picks the new colours up. function Ui.refreshTheme() local ok, theme = pcall(function() return (settings().Studio :: any).Theme end) -- Looked up by name inside pcall: a colour this Studio doesn't know falls back instead of -- breaking the plugin. local function get(name: string, fallback: number, hover: boolean?): Color3 if not ok or not theme then return rgb(fallback) end local got, value = pcall(function() local color = (Enum.StudioStyleGuideColor :: any)[name] local modifier = if hover then Enum.StudioStyleGuideModifier.Hover else Enum.StudioStyleGuideModifier.Default return theme:GetColor(color, modifier) end) return if got and typeof(value) == "Color3" then value else rgb(fallback) end C.bg = get("MainBackground", 0x2E2E2E) -- Claudio Background C.surface = get("Titlebar", 0x353535) -- Claudio Panel C.button = get("Button", 0x3C3C3C) C.buttonText = get("ButtonText", 0xE6E6E6) C.surface2 = C.button C.surface3 = get("Button", 0x454545, true) C.input = get("InputFieldBackground", 0x252525) C.code = get("ScriptBackground", 0x252525) C.codeText = get("ScriptText", 0xCCCCCC) C.line = get("Border", 0x222222) C.lineStrong = get("ButtonBorder", 0x3F3F3F) C.fg = get("MainText", 0xEAEAEA) C.fg3 = get("DimmedText", 0x858585) C.fg2 = readable(C.fg3, C.fg, C.surface) C.brand = get("DialogMainButton", 0x0077D6) -- Claudio Accent C.brandHover = get("DialogMainButton", 0x1A8BE3, true) C.onBrand = get("DialogMainButtonText", 0xFFFFFF) C.accent = get("LinkText", 0x35B5FF) C.danger = get("ErrorText", 0xFF4444) C.added = get("DiffTextAdditionBackground", 0x2F4A35) C.removed = get("DiffTextDeletionBackground", 0x4E2C2C) local dark = luminance(C.bg) < 0.5 C.ok = if dark then rgb(0x62C776) else rgb(0x188038) -- Claudio AddedText C.warn = if dark then rgb(0xEB9F86) else rgb(0xB4532A) end Ui.refreshTheme() -- Calls `redraw` after the Studio theme changes (light/dark), with Ui.C already refilled. function Ui.onThemeChanged(redraw: () -> ()): RBXScriptConnection? local ok, connection = pcall(function() return (settings().Studio :: any).ThemeChanged:Connect(function() Ui.refreshTheme() redraw() end) end) return if ok then connection else nil end Ui.SEVERITY_COLORS = { CRITICAL = rgb(0xE5625E), HIGH = rgb(0xDC8A5A), MEDIUM = rgb(0xCFA64E), LOW = rgb(0x8394BD), INFO = rgb(0x71717A), } local order = 0 local function nextOrder(): number order += 1 return order end Ui.nextOrder = nextOrder local function corner(instance: Instance, radius: number) local round = Instance.new("UICorner") round.CornerRadius = UDim.new(0, radius) round.Parent = instance end Ui.corner = corner local function padding(instance: Instance, x: number, y: number, right: number?, bottom: number?) local pad = Instance.new("UIPadding") pad.PaddingLeft = UDim.new(0, x) pad.PaddingRight = UDim.new(0, right or x) pad.PaddingTop = UDim.new(0, y) pad.PaddingBottom = UDim.new(0, bottom or y) pad.Parent = instance end Ui.padding = padding local function hlist(instance: Instance, gap: number, align: Enum.VerticalAlignment?): UIListLayout local layout = Instance.new("UIListLayout") layout.FillDirection = Enum.FillDirection.Horizontal layout.VerticalAlignment = align or Enum.VerticalAlignment.Center layout.SortOrder = Enum.SortOrder.LayoutOrder layout.Padding = UDim.new(0, gap) layout.Parent = instance return layout end Ui.hlist = hlist -- Lets a child take the room left in its row or column (Claudio's UIFlexItem Fill). function Ui.fill(instance: Instance) local flex = Instance.new("UIFlexItem") flex.FlexMode = Enum.UIFlexMode.Fill flex.Parent = instance end -- A thin outline. Kept for callers; Claudio only outlines what needs your attention. function Ui.glow(instance: GuiObject, color: Color3?, transparency: number?) local stroke = Instance.new("UIStroke") stroke.ApplyStrokeMode = Enum.ApplyStrokeMode.Border stroke.Color = color or C.line stroke.Transparency = transparency or 0 stroke.Thickness = 1 stroke.Parent = instance return stroke end -- Hover: fills `object` with `color` while the mouse is over it (Claudio's Covers.Hover). local function hover(object: GuiObject, color: Color3, onChange: ((boolean) -> ())?) object.BackgroundColor3 = color object.MouseEnter:Connect(function() object.BackgroundTransparency = 0 if onChange then onChange(true) end end) object.MouseLeave:Connect(function() object.BackgroundTransparency = 1 if onChange then onChange(false) end end) end function Ui.clear(container: Instance) for _, child in container:GetChildren() do if not child:IsA("UIListLayout") and not child:IsA("UIPadding") then child:Destroy() end end end function Ui.list(parent: Instance, gap: number?): Frame local frame = Instance.new("Frame") frame.BackgroundTransparency = 1 frame.Size = UDim2.new(1, 0, 0, 0) frame.AutomaticSize = Enum.AutomaticSize.Y frame.LayoutOrder = nextOrder() local layout = Instance.new("UIListLayout") layout.SortOrder = Enum.SortOrder.LayoutOrder layout.Padding = UDim.new(0, gap or 6) layout.Parent = frame frame.Parent = parent return frame end function Ui.row(parent: Instance): Frame local frame = Instance.new("Frame") frame.BackgroundTransparency = 1 frame.Size = UDim2.new(1, 0, 0, 0) frame.AutomaticSize = Enum.AutomaticSize.Y frame.LayoutOrder = nextOrder() local layout = hlist(frame, 6) layout.Wraps = true frame.Parent = parent return frame end export type TextOptions = { size: number?, bold: boolean?, medium: boolean?, color: Color3?, mono: boolean?, dim: boolean?, } function Ui.text(parent: Instance, text: string, options: TextOptions?): TextLabel local opts: TextOptions = options or {} local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.Size = UDim2.new(1, 0, 0, 0) label.AutomaticSize = Enum.AutomaticSize.Y label.TextWrapped = true label.TextXAlignment = Enum.TextXAlignment.Left label.TextYAlignment = Enum.TextYAlignment.Top label.RichText = false label.Text = text -- Claudio has two sizes; anything asked smaller than 13 is its small text. local size = opts.size or Ui.TEXT label.TextSize = if size >= 20 then size elseif size >= 15 then 15 elseif size >= 13 then Ui.TEXT else Ui.SMALL label.FontFace = if opts.mono then Ui.MONO elseif opts.bold then Ui.MEDIUM elseif opts.medium then Ui.MEDIUM else Ui.FONT if opts.mono then label.TextSize = Ui.SMALL end label.TextColor3 = opts.color or if opts.dim then C.fg2 else C.fg label.LayoutOrder = nextOrder() label.Parent = parent return label end -- One Builder Icons glyph (Claudio's Icon component). function Ui.icon(parent: Instance, name: string, size: number?, color: Color3?): TextLabel local label = Instance.new("TextLabel") label.Name = "Icon" label.AutomaticSize = Enum.AutomaticSize.XY label.Size = UDim2.new() label.BackgroundTransparency = 1 label.FontFace = Ui.ICON_FONT label.Text = name label.TextColor3 = color or C.fg2 label.TextSize = size or Ui.TEXT label.LayoutOrder = nextOrder() label.Parent = parent return label end export type ButtonOptions = { primary: boolean?, width: number?, danger: boolean?, small: boolean?, } -- Claudio's Button: sized to its text, 4 px corners, 10 × 5 padding, Studio's button colours. -- `width` is kept for callers and works as a minimum width. function Ui.button(parent: Instance, text: string, onClick: () -> (), options: ButtonOptions?): TextButton local opts: ButtonOptions = options or {} local button = Instance.new("TextButton") button.Name = "Button" button.AutoButtonColor = true button.Size = UDim2.new() button.AutomaticSize = Enum.AutomaticSize.XY button.Text = text button.TextSize = if opts.small then Ui.SMALL else Ui.TEXT button.FontFace = Ui.MEDIUM button.BackgroundColor3 = if opts.primary then C.brand else C.button button.TextColor3 = if opts.primary then C.onBrand elseif opts.danger then C.danger else C.buttonText button.BorderSizePixel = 0 button.LayoutOrder = nextOrder() corner(button, 4) if opts.small then padding(button, 8, 3) else padding(button, 10, 5) end if opts.width then local limit = Instance.new("UISizeConstraint") limit.MinSize = Vector2.new(math.min(opts.width, 60), 0) limit.Parent = button end button.Activated:Connect(onClick) button.Parent = parent return button end export type IconButtonOptions = { size: number?, active: boolean?, color: Color3? } -- Claudio's IconButton: a glyph that fills with the button colour under the mouse. function Ui.iconButton(parent: Instance, icon: string, onClick: () -> (), options: IconButtonOptions?): TextButton local opts: IconButtonOptions = options or {} local room = opts.size or Ui.TEXT local button = Instance.new("TextButton") button.Name = "IconButton" button.Size = UDim2.fromOffset(room + 10, room + 6) button.BackgroundTransparency = 1 button.BorderSizePixel = 0 button.AutoButtonColor = false button.FontFace = Ui.ICON_FONT button.Text = icon button.TextSize = room local rest = opts.color or (if opts.active then C.brand else C.fg2) button.TextColor3 = rest button.LayoutOrder = nextOrder() corner(button, 4) hover(button, C.button, function(over) button.TextColor3 = if over and not opts.active then C.fg else rest end) button.Activated:Connect(onClick) button.Parent = parent return button end -- Claudio's pill (mode and model pickers under the input): small medium text with a chevron, -- filled with the button colour under the mouse. function Ui.pill(parent: Instance, text: string, onClick: () -> (), dim: boolean?): TextButton local button = Instance.new("TextButton") button.Name = "Pill" button.Size = UDim2.new() button.AutomaticSize = Enum.AutomaticSize.XY button.BackgroundTransparency = 1 button.BorderSizePixel = 0 button.AutoButtonColor = false button.Text = "" button.LayoutOrder = nextOrder() corner(button, 4) padding(button, 5, 2) hlist(button, 2) local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.AutomaticSize = Enum.AutomaticSize.XY label.Size = UDim2.new() label.Text = text label.TextSize = Ui.SMALL label.FontFace = Ui.MEDIUM label.TextColor3 = if dim then C.fg2 else C.fg label.LayoutOrder = 1 label.Parent = button local chevron = Ui.icon(button, Ui.ICONS.Down, Ui.SMALL, C.fg2) chevron.LayoutOrder = 2 hover(button, C.button, function(over) chevron.TextColor3 = if over then C.fg else C.fg2 label.TextColor3 = if over or not dim then C.fg else C.fg2 end) button.Activated:Connect(onClick) button.Parent = parent return button end -- Claudio's text box look: the input colour, 4 px corners, no outline. function Ui.input(parent: Instance, placeholder: string, multiline: boolean?): TextBox local box = Instance.new("TextBox") box.Size = UDim2.new(1, 0, 0, if multiline then 64 else 28) box.ClearTextOnFocus = false box.MultiLine = multiline == true box.TextWrapped = multiline == true box.TextXAlignment = Enum.TextXAlignment.Left box.TextYAlignment = if multiline then Enum.TextYAlignment.Top else Enum.TextYAlignment.Center box.PlaceholderText = placeholder box.Text = "" box.TextSize = Ui.TEXT box.FontFace = Ui.FONT box.BackgroundColor3 = C.input box.TextColor3 = C.fg box.PlaceholderColor3 = C.fg2 box.BorderSizePixel = 0 box.LayoutOrder = nextOrder() padding(box, 8, if multiline then 5 else 0) corner(box, 4) box.Parent = parent return box end -- Read-only text the user can select and copy (Studio plugins cannot open a browser). function Ui.copyable(parent: Instance, text: string, mono: boolean?): TextBox local box = Ui.input(parent, "") box.Text = text box.TextEditable = false box.FontFace = if mono then Ui.MONO else Ui.FONT if mono then box.TextSize = Ui.SMALL end return box end -- Claudio's card: the panel colour, 8 px corners, 10 × 8 padding. Only a warning or an error -- gets an outline; everything else stays flat, as in Claudio. function Ui.card(parent: Instance, accent: Color3?): Frame local frame = Ui.list(parent, 6) frame.Name = "Card" frame.BackgroundTransparency = 0 frame.BackgroundColor3 = C.surface corner(frame, 8) padding(frame, 10, 8) if accent and (accent == C.warn or accent == C.danger) then Ui.glow(frame, accent, 0.45) end return frame end -- A small pill. Used sparingly: severity on a finding, not decoration. function Ui.badge(parent: Instance, text: string, color: Color3?): TextLabel local tint = color or C.fg2 local label = Instance.new("TextLabel") label.Size = UDim2.new(0, 0, 0, 16) label.AutomaticSize = Enum.AutomaticSize.X label.BackgroundColor3 = tint label.BackgroundTransparency = 0.86 label.BorderSizePixel = 0 label.Text = string.upper(text) label.TextSize = 10 label.FontFace = Ui.BOLD label.TextColor3 = tint label.LayoutOrder = nextOrder() corner(label, 8) padding(label, 6, 0) label.Parent = parent return label end -- A heading inside the panel, with an optional quiet line under it. function Ui.section(parent: Instance, title: string, hint: string?): Frame local frame = Ui.list(parent, 2) local pad = Instance.new("UIPadding") pad.PaddingTop = UDim.new(0, 4) pad.Parent = frame Ui.text(frame, title, { bold = true }) if hint then Ui.text(frame, hint, { size = 12, dim = true }) end return frame end export type NoticeKind = "info" | "success" | "warning" | "error" -- One plain sentence: what happened, or what to do. Errors and warnings are outlined. function Ui.notice(parent: Instance, kind: NoticeKind, text: string): Frame local color = if kind == "error" then C.danger elseif kind == "warning" then C.warn else nil local card = Ui.card(parent, color) local line = Ui.row(card) local glyph = if kind == "error" or kind == "warning" then Ui.ICONS.Warning elseif kind == "success" then Ui.ICONS.Chosen else nil if glyph then Ui.icon(line, glyph, Ui.SMALL, color or C.ok) end local label = Ui.text(line, text, { size = 12 }) label.Size = UDim2.new(1, if glyph then -20 else 0, 0, 0) return card end export type Tab = { id: string, label: string } -- Kept for callers: a row of buttons where the picked one is the main colour. function Ui.tabs(parent: Instance, tabs: { Tab }, selected: string, onSelect: (id: string) -> ()): Frame local bar = Ui.row(parent) for _, tab in tabs do Ui.button(bar, tab.label, function() onSelect(tab.id) end, { primary = tab.id == selected, small = true }) end return bar end export type Option = { id: string, label: string, detail: string?, recommended: boolean? } -- One question with its answers as rows (Claudio's mode menu rows): a check on the picked one. function Ui.choice(parent: Instance, options: { Option }, selected: string?, onSelect: (id: string) -> ()): Frame local frame = Ui.list(parent, 2) frame.BackgroundTransparency = 0 frame.BackgroundColor3 = C.surface corner(frame, 8) padding(frame, 4, 4) for _, option in options do local active = option.id == selected local button = Instance.new("TextButton") button.Size = UDim2.new(1, 0, 0, 0) button.AutomaticSize = Enum.AutomaticSize.Y button.BackgroundTransparency = if active then 0 else 1 button.BorderSizePixel = 0 button.AutoButtonColor = false button.Text = "" button.LayoutOrder = nextOrder() corner(button, 4) padding(button, 8, 5) if active then button.BackgroundColor3 = C.button else hover(button, C.button) end local inner = Instance.new("UIListLayout") inner.SortOrder = Enum.SortOrder.LayoutOrder inner.Padding = UDim.new(0, 1) inner.Parent = button local top = Ui.row(button) top.Active = false local title = Ui.text(top, option.label .. (if option.recommended then " (recommended)" else ""), { medium = true, size = 13 }) title.Size = UDim2.new(1, -24, 0, 0) if active then Ui.icon(top, Ui.ICONS.Chosen, Ui.SMALL, C.brand) end if option.detail then local detail = Ui.text(button, option.detail, { size = 12, dim = true }) detail.Active = false end button.Activated:Connect(function() onSelect(option.id) end) button.Parent = frame end return frame end export type Stat = { label: string, value: string, color: Color3? } -- A row of small figures, for example "2 critical · 1 high". function Ui.stats(parent: Instance, stats: { Stat }): Frame local row = Ui.row(parent) for _, stat in stats do local chip = Instance.new("Frame") chip.Size = UDim2.new(0, 0, 0, 0) chip.AutomaticSize = Enum.AutomaticSize.XY chip.BackgroundColor3 = C.bg chip.BorderSizePixel = 0 chip.LayoutOrder = nextOrder() corner(chip, 4) padding(chip, 8, 3) local layout = Instance.new("UIListLayout") layout.SortOrder = Enum.SortOrder.LayoutOrder layout.Parent = chip local value = Ui.text(chip, stat.value, { bold = true, size = 15, color = stat.color }) value.Size = UDim2.new(0, 0, 0, 0) value.AutomaticSize = Enum.AutomaticSize.XY value.TextWrapped = false local label = Ui.text(chip, stat.label, { size = 11, dim = true }) label.Size = UDim2.new(0, 0, 0, 0) label.AutomaticSize = Enum.AutomaticSize.XY label.TextWrapped = false chip.Parent = row end return row end export type DiffLine = { kind: string, text: string } -- A code diff in Claudio's code box: script background, 4 px corners, Studio's diff colours. function Ui.diff(parent: Instance, lines: { DiffLine }): Frame local frame = Ui.list(parent, 0) frame.Name = "Diff" frame.BackgroundTransparency = 0 frame.BackgroundColor3 = C.code frame.ClipsDescendants = true corner(frame, 4) padding(frame, 0, 4) for _, line in lines do local label = Ui.text(frame, (if line.kind == "@" then "" else line.kind .. " ") .. line.text, { mono = true }) label.TextWrapped = true label.TextColor3 = if line.kind == "+" then C.ok elseif line.kind == "-" then C.danger elseif line.kind == "@" then C.accent else C.codeText if line.kind == "+" or line.kind == "-" then label.BackgroundTransparency = 0 label.BackgroundColor3 = if line.kind == "+" then C.added else C.removed end padding(label, 6, 0) end return frame end -- A row of small rounded suggestions under a message, like "Check this place". function Ui.chips(parent: Instance): Frame return Ui.row(parent) end function Ui.chip(parent: Instance, text: string, onClick: () -> ()): TextButton local button = Instance.new("TextButton") button.AutoButtonColor = true button.Size = UDim2.new() button.AutomaticSize = Enum.AutomaticSize.XY button.Text = text button.TextSize = Ui.SMALL + 1 button.FontFace = Ui.FONT button.BackgroundColor3 = C.surface button.TextColor3 = C.fg button.BorderSizePixel = 0 button.LayoutOrder = nextOrder() corner(button, 12) padding(button, 10, 4) Ui.glow(button, C.line, 0) button.Activated:Connect(onClick) button.Parent = parent return button end -- A tool line inside a reply, as in Claudio: "● Read 42 scripts". The dot is green when done, -- red when it failed and dim while it runs. function Ui.step(parent: Instance, text: string, color: Color3?): Frame local row = Instance.new("Frame") row.Name = "ToolCall" row.BackgroundTransparency = 1 row.Size = UDim2.new(1, 0, 0, 0) row.AutomaticSize = Enum.AutomaticSize.Y row.LayoutOrder = nextOrder() hlist(row, 6, Enum.VerticalAlignment.Top) local dot = Instance.new("TextLabel") dot.BackgroundTransparency = 1 dot.Size = UDim2.fromOffset(10, 16) dot.Text = "●" dot.TextSize = 12 dot.FontFace = Ui.FONT dot.TextColor3 = color or C.ok dot.LayoutOrder = 1 dot.Parent = row local label = Ui.text(row, text, { size = 12 }) label.Size = UDim2.new(1, -16, 0, 0) label.TextColor3 = if color == C.danger then C.danger else C.fg2 label.LayoutOrder = 2 row.Parent = parent return row end Ui.toolLine = Ui.step export type BubbleRole = "user" | "assistant" -- One chat message (Claudio's MessageBubble): the person's own messages sit on the right in a -- panel-coloured bubble, 85 % wide at most; shipLua's replies are plain text on the panel. function Ui.bubble(parent: Instance, role: BubbleRole, text: string): Frame local row = Instance.new("Frame") row.Name = if role == "user" then "UserMessage" else "AssistantMessage" row.BackgroundTransparency = 1 row.Size = UDim2.new(1, 0, 0, 0) row.AutomaticSize = Enum.AutomaticSize.Y row.LayoutOrder = nextOrder() local layout = Instance.new("UIListLayout") layout.SortOrder = Enum.SortOrder.LayoutOrder layout.HorizontalAlignment = if role == "user" then Enum.HorizontalAlignment.Right else Enum.HorizontalAlignment.Left layout.Parent = row local bubble = Instance.new("Frame") bubble.Name = "Bubble" bubble.BorderSizePixel = 0 bubble.LayoutOrder = 1 if role == "user" then -- Sized to the text, never wider than 85 % of the panel. bubble.Size = UDim2.new() bubble.AutomaticSize = Enum.AutomaticSize.XY bubble.BackgroundColor3 = C.surface bubble.BackgroundTransparency = 0 corner(bubble, 8) padding(bubble, 10, 8) local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.AutomaticSize = Enum.AutomaticSize.XY label.Size = UDim2.new() label.TextWrapped = true label.TextXAlignment = Enum.TextXAlignment.Left label.Text = text label.TextSize = Ui.TEXT label.FontFace = Ui.FONT label.TextColor3 = C.fg label.Parent = bubble local limit = Instance.new("UISizeConstraint") limit.Parent = label local function fit() local width = row.AbsoluteSize.X if width > 0 then limit.MaxSize = Vector2.new(math.max(40, math.floor(width * 0.85) - 20), math.huge) end end row:GetPropertyChangedSignal("AbsoluteSize"):Connect(fit) task.defer(fit) else bubble.Size = UDim2.new(1, 0, 0, 0) bubble.AutomaticSize = Enum.AutomaticSize.Y bubble.BackgroundTransparency = 1 local inner = Instance.new("UIListLayout") inner.SortOrder = Enum.SortOrder.LayoutOrder inner.Padding = UDim.new(0, 6) inner.Parent = bubble Ui.text(bubble, text) end bubble.Parent = row row.Parent = parent return row end -- The line under a reply (Claudio's Actions row): the shipLua mark and quiet details such as -- "just now · 2,140 tokens". function Ui.replyFooter(parent: Instance, text: string): Frame local row = Instance.new("Frame") row.Name = "Actions" row.BackgroundTransparency = 1 row.Size = UDim2.new(1, 0, 0, 20) row.LayoutOrder = nextOrder() hlist(row, 6) local mark = Instance.new("Frame") mark.Size = UDim2.fromOffset(12, 12) mark.BackgroundColor3 = Ui.BRAND mark.BorderSizePixel = 0 mark.LayoutOrder = 1 corner(mark, 3) mark.Parent = row local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.AutomaticSize = Enum.AutomaticSize.X label.Size = UDim2.fromOffset(0, 16) label.Text = text label.TextSize = Ui.SMALL label.FontFace = Ui.FONT label.TextColor3 = C.fg2 label.LayoutOrder = 2 label.Parent = row row.Parent = parent return row end export type PermissionOptions = { title: string, detail: string?, warning: string?, onAllow: () -> (), onAllowChat: (() -> ())?, onDeny: () -> (), allowLabel: string?, } -- Claudio's PermissionCard: the panel colour outlined in the main colour (1.5 px), a medium -- title, what will change, and Allow / Allow for this chat / Deny. Returns the card so callers -- can put a diff in it before the buttons (the buttons are always last). function Ui.permission(parent: Instance, options: PermissionOptions): Frame local card = Ui.list(parent, 6) card.Name = "PermissionCard" card.BackgroundTransparency = 0 card.BackgroundColor3 = C.surface corner(card, 8) padding(card, 10, 8) local stroke = Instance.new("UIStroke") stroke.ApplyStrokeMode = Enum.ApplyStrokeMode.Border stroke.Color = if options.warning then C.warn else C.brand stroke.Thickness = 1.5 stroke.Parent = card Ui.text(card, options.title, { medium = true }) if options.warning then Ui.text(card, options.warning, { size = 12, color = C.warn }) end if options.detail then local box = Ui.text(card, options.detail, { mono = true }) box.BackgroundTransparency = 0 box.BackgroundColor3 = C.code box.TextColor3 = C.codeText corner(box, 4) padding(box, 6, 4) end local buttons = Instance.new("Frame") buttons.Name = "Buttons" buttons.BackgroundTransparency = 1 buttons.Size = UDim2.new(1, 0, 0, 0) buttons.AutomaticSize = Enum.AutomaticSize.Y buttons.LayoutOrder = 2000000000 -- always last, after anything a caller adds local layout = hlist(buttons, 6) layout.Wraps = true Ui.button(buttons, options.allowLabel or "Allow", options.onAllow, { primary = true }) if options.onAllowChat then Ui.button(buttons, "Allow for this chat", options.onAllowChat) end Ui.button(buttons, "Deny", options.onDeny) buttons.Parent = card return card end -- Claudio's usage ring: two half wedges cut with UIGradient over a dim disc, with a hole in the -- middle. `share` is 0 to 1. Returns the ring and a function that sets a new share. function Ui.usageRing(parent: Instance, share: number, edge: number?): (TextButton, (number) -> ()) local size = edge or 18 local ring = Instance.new("TextButton") ring.Name = "Usage" ring.Size = UDim2.fromOffset(size, size) ring.BackgroundColor3 = C.fg2 ring.BorderSizePixel = 0 ring.AutoButtonColor = false ring.Text = "" ring.LayoutOrder = nextOrder() corner(ring, size) local wedges: { { frame: Frame, gradient: UIGradient, order: number } } = {} for order, side in { "Right", "Left" } do local half = Instance.new("Frame") half.Name = side half.Size = UDim2.fromOffset(size / 2, size) half.Position = UDim2.fromOffset(if side == "Right" then size / 2 else 0, 0) half.BackgroundTransparency = 1 half.ClipsDescendants = true half.Parent = ring local wedge = Instance.new("Frame") wedge.Name = "Wedge" wedge.Size = UDim2.fromOffset(size, size) wedge.Position = UDim2.fromOffset(if side == "Right" then -size / 2 else 0, 0) wedge.BorderSizePixel = 0 wedge.Parent = half corner(wedge, size) local gradient = Instance.new("UIGradient") gradient.Transparency = NumberSequence.new({ NumberSequenceKeypoint.new(0, 0), NumberSequenceKeypoint.new(0.4999, 0), NumberSequenceKeypoint.new(0.5, 1), NumberSequenceKeypoint.new(1, 1), }) gradient.Parent = wedge table.insert(wedges, { frame = wedge, gradient = gradient, order = order }) end local hole = Instance.new("Frame") hole.Name = "Hole" hole.AnchorPoint = Vector2.new(0.5, 0.5) hole.Position = UDim2.fromScale(0.5, 0.5) hole.Size = UDim2.fromOffset(size - 6, size - 6) hole.BackgroundColor3 = C.surface hole.BorderSizePixel = 0 hole.ZIndex = 5 corner(hole, size) hole.Parent = ring local function set(value: number) local used = math.clamp(value, 0, 1) -- Claudio's colour: the main colour up to half, then amber toward the error colour. local colour = if used <= 0.5 then C.brand else Color3.fromRGB(214, 158, 46):Lerp(C.danger, math.clamp((used - 0.5) / 0.45, 0, 1)) for _, wedge in wedges do local portion = math.clamp((used - (wedge.order - 1) * 0.5) / 0.5, 0, 1) wedge.frame.Visible = portion > 0 wedge.frame.BackgroundColor3 = colour wedge.gradient.Rotation = (wedge.order - 1) * 180 + 180 * portion end end set(share) ring.Parent = parent return ring, set end -- Each Agent keeps one colour, picked from its name, so its icon looks the same everywhere. local AVATAR_COLORS = { 0x2F5BFF, 0x4CB782, 0xEB9F86, 0xC45BD8, 0xE5B13A, 0x4CB8C4, 0xE5625E, 0x8A8FF0 } function Ui.avatarColor(name: string): Color3 local sum = 0 for i = 1, #name do sum = (sum * 31 + string.byte(name, i)) % 1000003 end return rgb(AVATAR_COLORS[sum % #AVATAR_COLORS + 1]) end -- "Builder" → "Bu", "QA" → "QA", "Brain" → "B": the letters on an Agent's icon. function Ui.initials(name: string): string local upper = string.gsub(name, "[^%u]", "") if #upper >= 2 and #upper <= 3 and #name <= 4 then return upper end local first = string.match(name, "%w") or "?" if #name > 5 then local second = string.match(name, "^%w(%l)") if second then return string.upper(first) .. second end end return string.upper(first) end -- A round icon with the Agent's letters. `ring` draws the panel colour around it, so stacked -- icons look cut out of each other. `grey` is for a paused Agent. function Ui.avatar(parent: Instance, name: string, size: number?, ring: boolean?, grey: boolean?): Frame local px = size or 18 local dot = Instance.new("Frame") dot.Size = UDim2.fromOffset(px, px) dot.BackgroundColor3 = if grey then C.fg3 else Ui.avatarColor(name) dot.BorderSizePixel = 0 dot.LayoutOrder = nextOrder() corner(dot, px) if ring then local stroke = Instance.new("UIStroke") stroke.Color = C.bg stroke.Thickness = 2 stroke.Parent = dot end local letter = Instance.new("TextLabel") letter.BackgroundTransparency = 1 letter.Size = UDim2.fromScale(1, 1) letter.Text = if px >= 24 then Ui.initials(name) else string.upper(string.sub(name, 1, 1)) letter.TextSize = if px >= 24 then 11 else math.floor(px * 0.6) letter.FontFace = Ui.MEDIUM letter.TextColor3 = Color3.new(1, 1, 1) letter.Parent = dot dot.Parent = parent return dot end -- Up to four icons overlapping, like a stack of senders. function Ui.avatarStack(parent: Instance, names: { string }, size: number?): Frame local px = size or 18 local stack = Instance.new("Frame") stack.BackgroundTransparency = 1 stack.Size = UDim2.fromOffset(0, px) stack.AutomaticSize = Enum.AutomaticSize.X stack.LayoutOrder = nextOrder() local layout = hlist(stack, -math.floor(px * 0.35)) layout.Padding = UDim.new(0, -math.floor(px * 0.35)) for i = 1, math.min(#names, 4) do local dot = Ui.avatar(stack, names[i], px, true) dot.ZIndex = 10 - i dot.LayoutOrder = i end stack.Parent = parent return stack end -- "4 messages with (M) Mika and (Q) shipLua QA", or "5 messages with (stack) 5 agents" when -- more than two sent them. Clicking it opens the messages. function Ui.messageSummary(parent: Instance, count: number, names: { string }, onClick: (() -> ())?): TextButton local button = Instance.new("TextButton") button.AutoButtonColor = false button.BackgroundTransparency = 1 button.Text = "" button.Size = UDim2.new(1, 0, 0, 26) button.LayoutOrder = nextOrder() corner(button, 6) if onClick then hover(button, C.surface) end local layout = hlist(button, 6) layout.HorizontalAlignment = Enum.HorizontalAlignment.Center local function words(text: string, strong: boolean?) local label = Instance.new("TextLabel") label.BackgroundTransparency = 1 label.AutomaticSize = Enum.AutomaticSize.X label.Size = UDim2.fromOffset(0, 18) label.Text = text label.TextSize = Ui.SMALL label.FontFace = if strong then Ui.MEDIUM else Ui.FONT label.TextColor3 = if strong then C.fg else C.fg2 label.LayoutOrder = nextOrder() label.Parent = button end words(count .. (if count == 1 then " message with" else " messages with")) if #names > 2 then Ui.avatarStack(button, names, 16) words(#names .. " agents", true) else for i, name in names do if i == 2 then words("and") end Ui.avatar(button, name, 16) words(name, true) end end if onClick then button.Activated:Connect(onClick) end button.Parent = parent return button end -- One line someone sent: their icon and name on top, the text under it. function Ui.agentMessage(parent: Instance, from: string, text: string, fromYou: boolean): Frame if fromYou then return Ui.bubble(parent, "user", text) end local block = Ui.list(parent, 3) local top = Ui.row(block) Ui.avatar(top, from, 16) local name = Ui.text(top, from, { size = 12, bold = true }) name.AutomaticSize = Enum.AutomaticSize.XY name.Size = UDim2.fromOffset(0, 16) Ui.text(block, text) return block end -- While something works: Claudio's "✻" in the main colour, breathing, then quiet text. function Ui.progress(parent: Instance, text: string): Frame local row = Instance.new("Frame") row.Name = "Working" row.BackgroundTransparency = 1 row.Size = UDim2.new(1, 0, 0, 0) row.AutomaticSize = Enum.AutomaticSize.Y row.LayoutOrder = nextOrder() hlist(row, 6, Enum.VerticalAlignment.Top) local star = Instance.new("TextLabel") star.BackgroundTransparency = 1 star.Size = UDim2.fromOffset(12, 16) star.Text = "✻" star.TextSize = Ui.TEXT star.FontFace = Ui.FONT star.TextColor3 = C.brand star.LayoutOrder = 1 star.Parent = row local label = Ui.text(row, text, { size = 12, dim = true }) label.Size = UDim2.new(1, -18, 0, 0) label.LayoutOrder = 2 row.Parent = parent local info = TweenInfo.new(0.9, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut, -1, true) TweenService:Create(star, info, { TextTransparency = 0.6 }):Play() return row end Ui.working = Ui.progress -- A quiet message for an empty list, as Claudio's empty chat list: dim, centred text. function Ui.empty(parent: Instance, title: string, detail: string?): Frame local frame = Ui.list(parent, 4) local pad = Instance.new("UIPadding") pad.PaddingTop = UDim.new(0, 8) pad.PaddingBottom = UDim.new(0, 8) pad.Parent = frame local heading = Ui.text(frame, title, { medium = true }) heading.TextXAlignment = Enum.TextXAlignment.Center if detail then local text = Ui.text(frame, detail, { size = 12, dim = true }) text.TextXAlignment = Enum.TextXAlignment.Center end return frame end -- The panel header on the sign-in screens: the shipLua name with a small blue mark. function Ui.header(parent: Instance, title: string, subtitle: string?): Frame local frame = Ui.list(parent, 2) local top = Instance.new("Frame") top.BackgroundTransparency = 1 top.Size = UDim2.new(1, 0, 0, 22) top.LayoutOrder = nextOrder() hlist(top, 8) local mark = Instance.new("Frame") mark.Size = UDim2.fromOffset(8, 8) mark.BackgroundColor3 = Ui.BRAND mark.BorderSizePixel = 0 mark.LayoutOrder = 1 corner(mark, 4) mark.Parent = top local name = Instance.new("TextLabel") name.BackgroundTransparency = 1 name.AutomaticSize = Enum.AutomaticSize.X name.Size = UDim2.fromOffset(0, 22) name.Text = title name.TextSize = 15 name.FontFace = Ui.MEDIUM name.TextColor3 = C.fg name.LayoutOrder = 2 name.Parent = top top.Parent = frame if subtitle then Ui.text(frame, subtitle, { size = 12, dim = true }) end return frame end return Ui ]]>Changes 1 then break end end return total, first end -- The new text for one script edit, or nil and why. function Changes.editedSource(change: Change, current: string): (string?, string?) if change.op == "set_source" then return change.source or "", nil elseif change.op == "prepend" then return (change.text or "") .. "\n" .. current, nil elseif change.op == "edit_script" then local matches, at = count(current, change.find or "") if matches ~= 1 or not at then return nil, if matches == 0 then "The code to replace is not in the script any more." else "The code to replace appears more than once." end return string.sub(current, 1, at - 1) .. (change.replace or "") .. string.sub(current, at + #(change.find or "")), nil elseif change.op == "insert_after" then local matches, at = count(current, change.anchor or "") if matches ~= 1 or not at then return nil, if matches == 0 then "The line to add after is not in the script any more." else "The line to add after appears more than once." end local lineEnd = string.find(current, "\n", at + #(change.anchor or ""), true) if not lineEnd then return current .. "\n" .. (change.text or ""), nil end return string.sub(current, 1, lineEnd) .. (change.text or "") .. "\n" .. string.sub(current, lineEnd + 1), nil end return nil, "Not a script edit." end -- Unchanged lines at the start and end are folded; the rest shows as removed and added. function Changes.diff(before: string, after: string): { DiffLine } local a = if before == "" then {} else string.split(before, "\n") local b = string.split(after, "\n") local start = 1 while start <= #a and start <= #b and a[start] == b[start] do start += 1 end local endA, endB = #a, #b while endA >= start and endB >= start and a[endA] == b[endB] do endA -= 1 endB -= 1 end local lines: { DiffLine } = {} local from = math.max(1, start - 2) if from > 1 then table.insert(lines, { kind = "@", text = "line " .. from }) end for index = from, start - 1 do table.insert(lines, { kind = " ", text = a[index] }) end for index = start, endA do table.insert(lines, { kind = "-", text = a[index] }) end for index = start, endB do table.insert(lines, { kind = "+", text = b[index] }) end for index = endA + 1, math.min(#a, endA + 2) do table.insert(lines, { kind = " ", text = a[index] }) end -- Long rewrites stay readable in a narrow panel. if #lines > 80 then local cut = {} for index = 1, 80 do cut[index] = lines[index] end table.insert(cut, { kind = "@", text = "… " .. (#lines - 80) .. " more lines" }) return cut end return lines end -- Full names the batch creates, so later changes may put things inside them. function Changes.created(changes: { Change }): { [string]: boolean } local pending: { [string]: boolean } = {} for _, change in changes do if (change.op == "create_script" or change.op == "create_instance") and change.parentPath and change.name then pending[change.parentPath .. "." .. change.name] = true end end return pending end function Changes.isScriptEdit(change: Change): boolean return change.op == "edit_script" or change.op == "set_source" or change.op == "insert_after" or change.op == "prepend" end local function hasRobuxWord(text: any): boolean if type(text) ~= "string" then return false end for _, word in ROBUX_WORDS do if string.find(text, word, 1, true) then return true end end return false end -- Code that touches purchases always waits for the person, in every approval mode. That -- includes what a change replaces or removes: rewriting or deleting a receipt handler counts, -- even when the new text never mentions purchases. function Changes.touchesRobux(change: Change): boolean for _, text in { change.find, change.replace, change.source, change.text } do if hasRobuxWord(text) then return true end end local removes = change.op == "delete_instance" if not (removes or Changes.isScriptEdit(change)) then return false end local target = Changes.resolve(change.path) if not target then return false end local function purchaseScript(node: Instance): boolean return SCRIPT_CLASSES[node.ClassName] ~= nil and hasRobuxWord(Changes.readSource(node)) end if purchaseScript(target) then return true end if removes then for _, node in target:GetDescendants() do if purchaseScript(node) then return true end end end return false end -- What one change would do, as a title and a diff, without changing anything. `pending` holds -- the full names that earlier changes in the same batch create. function Changes.preview(change: Change, pending: { [string]: boolean }?): Preview local function exists(path: string?): boolean return (pending ~= nil and path ~= nil and pending[path] == true) or Changes.resolve(path) ~= nil end if Changes.isScriptEdit(change) then local target = Changes.resolve(change.path) if not target or not SCRIPT_CLASSES[target.ClassName] then return { title = "Edit " .. tostring(change.path), lines = {}, error = "That script is not in the place." } end local current = Changes.readSource(target) local after, problem = Changes.editedSource(change, current) if not after then return { title = "Edit " .. tostring(change.path), lines = {}, error = problem } end return { title = "Edit " .. tostring(change.path), lines = Changes.diff(current, after) } elseif change.op == "create_script" then local title = "New " .. tostring(change.className) .. " " .. tostring(change.parentPath) .. "." .. tostring(change.name) if not exists(change.parentPath) then return { title = title, lines = {}, error = "The folder to put it in is not in the place." } end local parent = Changes.resolve(change.parentPath) if parent and parent:FindFirstChild(change.name or "") then return { title = title, lines = {}, error = "There is already something with that name there." } end if not SCRIPT_CLASSES[change.className or ""] then return { title = title, lines = {}, error = "Not a script class." } end return { title = title, lines = Changes.diff("", change.source or "") } elseif change.op == "create_instance" then local title = "New " .. tostring(change.className) .. " " .. tostring(change.parentPath) .. "." .. tostring(change.name) if not SAFE_CLASSES[change.className or ""] then return { title = title, lines = {}, error = "shipLua only creates folders, remotes and values this way." } end return { title = title, lines = {}, error = if exists(change.parentPath) then nil else "The parent is not in the place." } elseif change.op == "set_property" then local target = Changes.resolve(change.path) local title = "Set " .. tostring(change.path) .. "." .. tostring(change.property) if not target then return { title = title, lines = {}, error = "That instance is not in the place." } end local read, old = pcall(function() return (target :: any)[change.property] end) return { title = title, lines = { { kind = "-", text = if read then tostring(old) else "?" }, { kind = "+", text = tostring(change.value) } }, error = if read then nil else "That property cannot be read.", } elseif change.op == "delete_instance" then local target = Changes.resolve(change.path) return { title = "Delete " .. tostring(change.path), lines = {}, error = if target then nil else "That instance is not in the place." } end return { title = tostring(change.op), lines = {}, error = "Unknown change." } end -- Plain words for what Studio said when an edit was refused. function Changes.explain(problem: any): string local text = tostring(problem) local lower = string.lower(text) if string.find(lower, "inject", 1, true) or string.find(lower, "permission", 1, true) or string.find(lower, "not allowed", 1, true) then return "Studio blocked the edit. Allow script changes for shipLua: Plugins tab › Manage Plugins › shipLua › turn on Script Injection, then try again." end if string.find(lower, "draft", 1, true) or string.find(lower, "locked", 1, true) or string.find(lower, "collaborat", 1, true) then return "Someone else is editing this script, or it has drafts that are not committed (Team Create). Commit your drafts in the Drafts window or ask your collaborator, then try again." end return "Studio refused the change: " .. string.sub(text, 1, 200) end type Undo = () -> () -- Writes one script edit through the editor, recomputed from the text Studio hands over, so an -- edit never lands on text other than what was checked. Returns the text it replaced. local function writeSource(target: Instance, change: Change): string? local replaced: string? = nil ScriptEditorService:UpdateSourceAsync(target :: any, function(old: string): string? local after = Changes.editedSource(change, old) if after then replaced = old end return after end) return replaced end local function restoreSource(target: Instance, source: string) ScriptEditorService:UpdateSourceAsync(target :: any, function(): string? return source end) end -- Applies every change or none. Returns ok, a sentence for the person, and how many applied. function Changes.applyBatch(summary: string, changes: { Change }): (boolean, string, number) -- Check everything first, so a bad change stops the batch before anything is touched. local pending = Changes.created(changes) for index, change in changes do local preview = Changes.preview(change, pending) if preview.error then return false, "Change " .. index .. " (" .. preview.title .. "): " .. preview.error .. " Nothing was changed.", 0 end end local recording = ChangeHistoryService:TryBeginRecording("shipLua", "shipLua: " .. string.sub(summary, 1, 80)) if not recording then return false, "Studio is busy (a test is running, or another plugin is changing the place). Stop it and try again. Nothing was changed.", 0 end local undo: { Undo } = {} local applied = 0 local ok, problem = pcall(function() for _, change in changes do if Changes.isScriptEdit(change) then local target = Changes.resolve(change.path) :: Instance local before = writeSource(target, change) if not before then error("The script changed while the edit was applied: " .. tostring(change.path)) end local original: string = before table.insert(undo, function() restoreSource(target, original) end) elseif change.op == "create_script" then local created: any = Instance.new(change.className :: string) created.Name = change.name created.Source = change.source or "" created.Parent = Changes.resolve(change.parentPath) table.insert(undo, function() created:Destroy() end) elseif change.op == "create_instance" then local created = Instance.new(change.className :: string) created.Name = change.name :: string created.Parent = Changes.resolve(change.parentPath) table.insert(undo, function() created:Destroy() end) elseif change.op == "set_property" then local target = Changes.resolve(change.path) :: any local old = target[change.property] target[change.property] = change.value table.insert(undo, function() target[change.property] = old end) elseif change.op == "delete_instance" then local target = Changes.resolve(change.path) :: Instance local parent = target.Parent target.Parent = nil table.insert(undo, function() target.Parent = parent end) end applied += 1 end end) if not ok then for index = #undo, 1, -1 do pcall(undo[index]) end ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Cancel) return false, Changes.explain(problem) .. " Everything in this change was put back.", 0 end ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit) return true, "Applied " .. applied .. (if applied == 1 then " change" else " changes") .. ". Ctrl+Z undoes all of it.", applied end return Changes ]]>HighlightBridge any export type State = { running: boolean, connected: boolean, problem: string?, cli: { [string]: any }?, } function Bridge.new(port: number, handlers: { [string]: Handler }, info: () -> { [string]: any }, onChange: () -> ()) local self = setmetatable({}, Bridge) self.port = port self.handlers = handlers self.info = info self.onChange = onChange self.code = "" self.serial = 0 self.state = { running = false, connected = false, problem = nil, cli = nil } :: State return self end function Bridge:post(path: string, body: { [string]: any }): (boolean, any, number) local sent, result = pcall(function() return HttpService:RequestAsync({ Url = "http://127.0.0.1:" .. self.port .. path, Method = "POST", Headers = { ["Content-Type"] = "application/json", ["x-shiplua-bridge"] = self.code }, Body = HttpService:JSONEncode(body), }) end) if not sent then return false, tostring(result), 0 end local decoded = nil pcall(function() decoded = HttpService:JSONDecode(result.Body) end) return result.StatusCode >= 200 and result.StatusCode < 300, decoded, result.StatusCode end function Bridge:setState(connected: boolean, problem: string?) if self.state.connected ~= connected or self.state.problem ~= problem then self.state.connected = connected self.state.problem = problem self.onChange() end end -- Runs one request from the CLI and posts its answer; a failing handler becomes an error answer. function Bridge:serve(request: { [string]: any }) local handler = self.handlers[request.tool] local ok, result if handler then ok, result = pcall(handler, if type(request.args) == "table" then request.args else {}) else ok, result = false, "This shipLua plugin does not know " .. tostring(request.tool) .. ". Update the plugin." end local body = { id = request.id, ok = ok } if ok then body.result = result else body.error = string.gsub(tostring(result), "^.-:%d+: ", "") end local sent = self:post("/bridge/result", body) if not sent then -- An answer too large or not encodable: say so instead of leaving the agent waiting. self:post("/bridge/result", { id = request.id, ok = false, error = "Studio could not send the answer (too large?)." }) end end function Bridge:start(code: string) self.code = string.upper(string.gsub(code, "[^%a]", "")) self.serial += 1 local serial = self.serial self.state.running = true self.onChange() task.spawn(function() local failures = 0 while serial == self.serial do local ok, body, status = self:post("/bridge/poll", self.info()) if serial ~= self.serial then return end if ok and type(body) == "table" then failures = 0 self.state.cli = if type(body.cli) == "table" then body.cli else nil self:setState(true, nil) for _, request in (if type(body.requests) == "table" then body.requests else {}) do task.spawn(function() self:serve(request) end) end else failures += 1 local problem = if status == 401 then "The bridge code does not match. Copy it again from the shiplua window." elseif status == 0 and type(body) == "string" and string.find(body, "Http", 1, true) then "Allow HTTP requests for shipLua when Studio asks (localhost), then try again." else "Waiting for shiplua on this computer. Run \"shiplua bridge\", or start your AI tool with shiplua-mcp." self:setState(false, problem) task.wait(math.min(2 + failures, 10)) end end end) end function Bridge:stop() self.serial += 1 self.state.running = false self.state.connected = false self.state.problem = nil self.onChange() end return Bridge ]]>SdkPlaceTools 1 then local children = {} for index, child in item:GetChildren() do if index > MAX_CHILDREN then break end table.insert(children, describe(child, depth - 1)) end entry.children = children end return entry end function PlaceTools.listInstances(args: { [string]: any }): any local depth = math.clamp(tonumber(args.depth) or 1, 1, 3) if type(args.path) ~= "string" or args.path == "" then local services = {} for _, name in SERVICES do local found, service = pcall(function() return game:GetService(name) end) if found and service then table.insert(services, describe(service, depth)) end end return { path = "game", children = services } end local target = must(args.path) local entry = describe(target, depth + 1) entry.path = target:GetFullName() return entry end function PlaceTools.getProperties(args: { [string]: any }): any local target = must(args.path) local properties: { [string]: any } = {} for _, name in COMMON_PROPERTIES do local read, value = pcall(function() return (target :: any)[name] end) if read and value ~= nil then properties[name] = if typeof(value) == "Instance" then value:GetFullName() else tostring(value) end end local attributes = {} for key, value in target:GetAttributes() do attributes[key] = tostring(value) end return { path = target:GetFullName(), properties = properties, attributes = attributes } end function PlaceTools.readSource(args: { [string]: any }): any local target = must(args.path) if not target:IsA("LuaSourceContainer") then error(target:GetFullName() .. " is a " .. target.ClassName .. ", not a script.") end local lines = string.split(Changes.readSource(target), "\n") local first = math.max(1, tonumber(args.startLine) or 1) local last = math.min(#lines, tonumber(args.endLine) or #lines, first + 1999) local out = {} for index = first, last do table.insert(out, index .. "\t" .. lines[index]) end return { path = target:GetFullName(), className = target.ClassName, lineCount = #lines, startLine = first, endLine = last, source = table.concat(out, "\n"), } end function PlaceTools.find(args: { [string]: any }): any local query = string.lower(tostring(args.query or "")) if query == "" then error("query is empty.") end local limit = math.clamp(tonumber(args.limit) or 50, 1, 200) local matches = {} for _, name in SERVICES do local found, service = pcall(function() return game:GetService(name) end) if found and service then for _, item in service:GetDescendants() do if #matches >= limit then return { matches = matches, truncated = true } end if args["in"] == "names" then if string.find(string.lower(item.Name), query, 1, true) then table.insert(matches, { path = item:GetFullName(), className = item.ClassName }) end elseif item:IsA("LuaSourceContainer") then local read, source = pcall(Changes.readSource, item) if read then for number, line in string.split(source, "\n") do if string.find(string.lower(line), query, 1, true) then table.insert(matches, { path = item:GetFullName(), line = number, text = string.sub(line, 1, 200) }) if #matches >= limit then break end end end end end end end end return { matches = matches, truncated = false } end local MESSAGE_KINDS = { [Enum.MessageType.MessageOutput] = "output", [Enum.MessageType.MessageInfo] = "info", [Enum.MessageType.MessageWarning] = "warning", [Enum.MessageType.MessageError] = "error", } function PlaceTools.logs(args: { [string]: any }): any local limit = math.clamp(tonumber(args.limit) or 100, 1, 500) local history = LogService:GetLogHistory() local out = {} for index = math.max(1, #history - limit + 1), #history do local entry = history[index] table.insert(out, { kind = MESSAGE_KINDS[entry.messageType] or "output", text = string.sub(entry.message, 1, 500) }) end return { lines = out } end -- A server-only Run test (no player). Play with a character is started by the person. function PlaceTools.playtest(args: { [string]: any }): any if args.action == "stop" then local stopped = pcall(function() RunService:Stop() end) return { ok = stopped, message = if stopped then "Stopped the test." else "No test was running." } end if RunService:IsRunning() then return { ok = false, message = "A test is already running." } end local started, problem = pcall(function() RunService:Run() end) return { ok = started, message = if started then "Started a Run test. Read get_output_log in a few seconds." else "Studio did not start the test: " .. tostring(problem) } end return PlaceTools ]]>Agent (), -- Tells shipLua the place changed, so open dashboards refresh. No-op when signed out. report: (kind: string, count: number) -> (), info: () -> { [string]: any }, handlers: { [string]: (args: { [string]: any }) -> any }, -- Called when a change starts waiting for the person. onWaiting: () -> (), } function Agent.new(ctx: Context) local self = setmetatable({}, Agent) self.ctx = ctx local mode = ctx.plugin:GetSetting(SETTING_MODE) self.mode = if type(mode) == "string" then mode else "manual" local code = ctx.plugin:GetSetting(SETTING_CODE) self.code = if type(code) == "string" then code else "" self.batches = {} :: { Batch } -- Set by "Allow for this chat"; New clears it. self.allowChat = false local handlers = table.clone(ctx.handlers) handlers.apply_changes = function(args) return self:submit(args) end handlers.change_status = function(args) for _, batch in self.batches do if batch.id == args.batchId then return self:describe(batch) end end error("No change with that id in this Studio session.") end handlers.history = function() local out = {} for _, batch in self.batches do table.insert(out, { batchId = batch.id, summary = batch.summary, status = batch.status, changes = #batch.changes, message = batch.message }) end return { batches = out } end self.bridge = Bridge.new(Config.bridgePort, handlers, function() local info = ctx.info() info.mode = self.mode return info end, ctx.render) if ctx.plugin:GetSetting(SETTING_ON) == true and self.code ~= "" then -- Deferred: the panel finishes building before the first redraw. task.defer(function() self.bridge:start(self.code) end) end return self end function Agent:describe(batch: Batch): { [string]: any } local previews = {} for _, preview in batch.previews do table.insert(previews, { title = preview.title, problem = preview.error }) end return { batchId = batch.id, status = if batch.status == "waiting" then "waiting_for_approval" else batch.status, summary = batch.summary, message = batch.message or (if batch.status == "waiting" then "Waiting for the person to approve it in the shipLua panel. Call get_change_status later." else nil), changes = previews, touchesPurchases = batch.liveImpact, } end function Agent:apply(batch: Batch) local ok, message, count = Changes.applyBatch(batch.summary, batch.changes) batch.status = if ok then "applied" else "failed" batch.message = message if ok then task.spawn(self.ctx.report, batch.activity, count) end self.ctx.render() end -- One reply from the AI tool. Returns its status once decided, or "waiting" after a while. function Agent:submit(args: { [string]: any }): { [string]: any } if type(args.changes) ~= "table" or #args.changes == 0 then error("changes is empty.") end local previews = {} local touches = args.liveImpact == true local pending = Changes.created(args.changes) for _, change in args.changes do table.insert(previews, Changes.preview(change, pending)) touches = touches or Changes.touchesRobux(change) end local batch: Batch = { id = HttpService:GenerateGUID(false), summary = string.sub(tostring(args.summary or "Changes from your AI tool"), 1, 200), changes = args.changes, previews = previews, liveImpact = touches, forceApproval = args.forceApproval == true, activity = if type(args.activity) == "string" then args.activity else "changes_applied", status = "waiting", message = nil, } table.insert(self.batches, 1, batch) while #self.batches > HISTORY do table.remove(self.batches) end local allEdits = true for _, change in batch.changes do allEdits = allEdits and Changes.isScriptEdit(change) end local mustAsk = batch.liveImpact or batch.forceApproval if self.mode == "plan" and not batch.forceApproval then batch.status = "planned" batch.message = "Plan mode: recorded as a proposal. Nothing was changed." elseif not mustAsk and (self.allowChat or self.mode == "auto" or (self.mode == "accept_edits" and allEdits)) then self:apply(batch) end if batch.status == "waiting" then self.ctx.onWaiting() end self.ctx.render() local deadline = os.clock() + math.min(tonumber(args.waitMs) or 45000, MAX_WAIT * 1000) / 1000 while batch.status == "waiting" and os.clock() < deadline do task.wait(0.5) end return self:describe(batch) end function Agent:setMode(mode: string) self.mode = mode self.ctx.plugin:SetSetting(SETTING_MODE, mode) self.ctx.render() end function Agent:connect(code: string) self.code = string.upper(string.gsub(code, "[^%a]", "")) self.ctx.plugin:SetSetting(SETTING_CODE, self.code) self.ctx.plugin:SetSetting(SETTING_ON, true) self.bridge:start(self.code) end function Agent:disconnect() self.ctx.plugin:SetSetting(SETTING_ON, false) self.bridge:stop() end function Agent:waiting(): number local count = 0 for _, batch in self.batches do if batch.status == "waiting" then count += 1 end end return count end local STATUS_WORDS = { waiting = "Waiting for you", applied = "Applied", rejected = "Rejected", planned = "Proposed only", failed = "Failed, put back", } -- One waiting reply as Claudio's permission card: what it changes, the diff, and Allow, Allow for -- this chat or Deny. Allow for this chat applies later replies in this chat without asking, -- except anything that touches purchases, which always waits. local function renderBatch(self, parent: Instance, batch: Batch) -- What it will do, as tool lines above the card ("● Edit ServerScriptService.Shop"). for _, preview in batch.previews do Ui.step(parent, preview.title, if preview.error then Ui.C.danger else Ui.C.fg2) end local count = #batch.previews local card = Ui.permission(parent, { title = if count == 1 then "Apply this change?" else "Apply these " .. count .. " changes?", warning = if batch.liveImpact then "This touches purchases. Check every price and product before you allow it." else nil, onAllow = function() if batch.status == "waiting" then self:apply(batch) end end, onAllowChat = if batch.liveImpact or batch.forceApproval then nil else function() self.allowChat = true if batch.status == "waiting" then self:apply(batch) end end, onDeny = function() if batch.status == "waiting" then batch.status = "rejected" batch.message = "The person rejected this change. Nothing was changed." self.ctx.render() end end, }) Ui.text(card, batch.summary, { size = 12, dim = true }) for _, preview in batch.previews do if count > 1 then Ui.text(card, preview.title, { mono = true, dim = true }) end if preview.error then Ui.text(card, preview.error, { size = 12, color = Ui.C.danger }) elseif #preview.lines > 0 then Ui.diff(card, preview.lines) end end local edit = Highlight.firstEdit(batch.changes) if edit then if batch.showLineError then Ui.notice(card, "warning", batch.showLineError) end Ui.button(card, "Show line", function() batch.showLineError = Highlight.showChange(self.ctx.plugin, edit) if batch.showLineError then self.ctx.render() end end, { small = true }) end end -- The replies waiting for the person, at the end of the chat like Claudio's permission card. function Agent:renderWaiting(body: Instance): number local count = 0 for _, batch in self.batches do if batch.status == "waiting" then count += 1 renderBatch(self, body, batch) end end if count > 0 then Ui.progress(body, "Waiting for you · each reply is one Ctrl+Z") end return count end function Agent:render(body: Instance, siteBase: string) local state = self.bridge.state Ui.section(body, "Your AI tool", "Claude Code, Codex or Cursor can read this place and propose changes through the shipLua CLI. You approve them here.") local card = Ui.card(body, if state.connected then Ui.C.ok else nil) if not state.running then Ui.text(card, "1. Install the shipLua CLI, then run \"shiplua bridge\" (or add shiplua-mcp to your AI tool).", { size = 12, dim = true }) Ui.text(card, "Windows (PowerShell)", { size = 11, dim = true }) Ui.copyable(card, "irm " .. siteBase .. "/cli/install.ps1 -OutFile $env:TEMP\\shiplua-install.ps1", true) Ui.copyable(card, "powershell -ExecutionPolicy Bypass -File $env:TEMP\\shiplua-install.ps1", true) Ui.text(card, "Windows Security blocked the install? This can be a false positive. Keep Windows Security enabled. Check Protection history for the detection name, update security definitions, and retry the official download. If it is still blocked, stop and contact shipLua support with the detection name.", { size = 12, dim = true }) Ui.text(card, "macOS (Terminal)", { size = 11, dim = true }) Ui.copyable(card, "curl -fsSL " .. siteBase .. "/cli/install.sh | sh", true) Ui.text(card, "2. Enter the bridge code it shows:", { size = 12, dim = true }) local box = Ui.input(card, "ABCD-EFGH") box.Text = self.code Ui.button(card, "Connect AI tools", function() if #string.gsub(box.Text, "[^%a]", "") == 8 then self:connect(box.Text) end end, { primary = true }) Ui.text(card, "Setup for each tool: " .. siteBase .. "/docs/ai-setup", { size = 11, dim = true }) else Ui.text(card, if state.connected then "Connected to shiplua on this computer" else "AI tool bridge offline, trying again…", { bold = true, color = if state.connected then Ui.C.ok else Ui.C.warn }) if not state.connected then Ui.text(card, "Is \"shiplua bridge\" (or your AI tool) still running on this computer? Changes wait here until it is back.", { size = 12, dim = true }) end if state.problem then Ui.text(card, state.problem, { size = 12, dim = true }) end local cli = state.cli if cli and type(cli.latest) == "string" and type(cli.version) == "string" and cli.latest ~= cli.version then Ui.text(card, "shiplua " .. cli.latest .. " is out. It updates itself when idle; restart it after.", { size = 12, dim = true }) end Ui.button(card, "Disconnect", function() self:disconnect() end) end Ui.section(body, "When your AI tool changes something") Ui.choice(body, Agent.MODES :: any, self.mode, function(id) self:setMode(id) end) local waiting = {} local done = {} for _, batch in self.batches do table.insert(if batch.status == "waiting" then waiting else done, batch) end if #waiting > 0 then Ui.section(body, "Waiting for you", "Each change shows what it does. Approve applies the whole reply as one Ctrl+Z.") for _, batch in waiting do renderBatch(self, body, batch) end end if #done > 0 then Ui.section(body, "This session") for index, batch in done do if index > 8 then break end local row = Ui.card(body) Ui.text(row, batch.summary, { size = 13, bold = true }) Ui.text(row, (STATUS_WORDS[batch.status] or batch.status) .. (if batch.message then ": " .. batch.message else ""), { size = 12, color = if batch.status == "failed" then Ui.C.danger elseif batch.status == "applied" then Ui.C.ok else Ui.C.fg2, }) end end end return Agent ]]>Funnels any, render: () -> (), siteBase: string, report: (kind: string, count: number) -> (), } type Choice = { enabled: boolean, label: string?, placement: number } function Funnels.new(ctx: Context) local self = setmetatable({}, Funnels) self.ctx = ctx self.stage = "route" -- route | planning | sdk | steps | preview | done | files | paste self.route = "studio" self.plan = nil :: any self.choices = {} :: { [string]: Choice } self.includeFix = true self.notice = nil :: { kind: string, text: string }? self.saved = nil :: any self.status = nil :: any self.busy = false self.sdkFiles = nil :: any self.serial = 0 self.placeCount = 1 return self end -- How many places the published game has. Funnel code goes into the open place only. local function countPlaces(): number if game.GameId <= 0 then return 1 end local ok, pages = pcall(function() return AssetService:GetGamePlacesAsync() end) if not ok then return 1 end local total = 0 while true do for _ in pages:GetCurrentPage() do total += 1 end if pages.IsFinished or total > 50 then break end local advanced = pcall(function() pages:AdvanceToNextPageAsync() end) if not advanced then break end end return math.max(total, 1) end function Funnels:say(kind: string, text: string) self.notice = { kind = kind, text = text } self.ctx.render() end -- Reads the place's scripts and asks shipLua for the plan. Used by the panel and the AI tool. function Funnels:fetchPlan(): (any, string?) local snapshot = Snapshot.collect() if snapshot.error or not snapshot.json then return nil, snapshot.error or "The place could not be read." end local query = "/studio/funnel-setup/plan?published=" .. (if game.PlaceId > 0 then "1" else "0") local response = self.ctx.api():request("POST", query, snapshot.json, true) if not response.ok then return nil, response.message end return response.body.plan, nil end function Funnels:loadPlan() if self.busy then return end self.busy = true self.stage = "planning" self.notice = nil self.ctx.render() local plan, problem = self:fetchPlan() self.busy = false if not plan then self.stage = "route" self:say("error", problem or "shipLua could not plan the funnel.") return end self.plan = plan self.placeCount = countPlaces() self.choices = {} for _, step in plan.steps do self.choices[step.key] = { enabled = true, label = nil, placement = 1 } end if self.route == "paste" then self.stage = "paste" elseif plan.sdk.state == "missing" or plan.sdk.state == "outdated" then self.stage = "sdk" else self.stage = "steps" end self.ctx.render() end -- The edits for the steps that are kept, each shared edit once, as changes for the place. function Funnels:selectedChanges(): { Changes.Change } local plan = self.plan local seen: { [string]: boolean } = {} local out: { Changes.Change } = {} local function add(placement: any) if not placement then return end for _, edit in placement.edits do if not seen[edit.id] then seen[edit.id] = true if edit.op == "create_script" then table.insert(out, { op = "create_script", parentPath = edit.parentPath, name = edit.name, className = edit.className, source = edit.text }) elseif edit.op == "prepend" then table.insert(out, { op = "prepend", path = edit.scriptPath, text = edit.text }) else table.insert(out, { op = "insert_after", path = edit.scriptPath, anchor = edit.anchor, text = edit.text }) end end end end for _, step in plan.steps do local choice = self.choices[step.key] if choice and choice.enabled and not step.alreadyTracked then add(step.placements[choice.placement]) end end if self.includeFix then add(plan.purchaseFix) end return out end function Funnels:keptSteps(): { { key: string, label: string? } } local steps = {} for _, step in self.plan.steps do local choice = self.choices[step.key] if choice and choice.enabled then table.insert(steps, { key = step.key, label = choice.label }) end end return steps end -- Saves the dashboard funnel. Returns the saved funnel, or nil and why. function Funnels:save(steps: any, name: string?): (any, string?) local response = self.ctx.api():request("POST", "/studio/funnel-setup/funnel", { name = name or "New player journey", steps = steps, }) if not response.ok then return nil, response.message end return response.body, nil end function Funnels:fetchStatus(): any local response = self.ctx.api():request("GET", "/studio/funnel-setup/status") return if response.ok then response.body else nil end -- After saving: "waiting for first events" until they arrive, while the panel is open. function Funnels:watch() self.serial += 1 local serial = self.serial task.spawn(function() for _ = 1, 40 do if serial ~= self.serial then return end local status = self:fetchStatus() if serial ~= self.serial then return end if status then self.status = status self.ctx.render() if status.state == "live" then return end end task.wait(15) end end) end function Funnels:finish() local steps = self:keptSteps() if #steps < 2 then self:say("warning", "Keep at least two steps for a funnel.") return end local saved, problem = self:save(steps, nil) if not saved then self:say("error", "The code is in, but the funnel was not saved: " .. tostring(problem)) return end self.saved = saved self.stage = "done" self.ctx.render() self:watch() end function Funnels:approve() if self.busy then return end local changes = self:selectedChanges() if #changes == 0 then self:finish() return end self.busy = true local ok, message, count = Changes.applyBatch("Add funnel tracking", changes) self.busy = false if not ok then self:say("error", message) return end task.spawn(self.ctx.report, "funnel_code_applied", count) self.notice = { kind = "success", text = message } self:finish() end function Funnels:installSdk() if self.busy then return end self.busy = true self.ctx.render() local files = self.sdkFiles local ok, message = Changes.applyBatch("Add the shipLua SDK " .. files.version, Sdk.changes(files)) self.busy = false if ok then task.spawn(self.ctx.report, "sdk_installed", 1) self.sdkFiles = nil self.notice = { kind = "success", text = message .. " Finish the SDK setup with your ingest key (SDK setup on the website), then funnels start counting.", } -- Plan again, so the edits load the SDK from where it now is. self:loadPlan() else self:say("error", message) end end -- ───────────── View ───────────── function Funnels:renderRoute(body: Instance) Ui.section(body, "Set up funnels", "See where new players drop off: joins, does the main thing, gets a reward, buys, comes back the next day.") Ui.text(body, "How do you edit this game's code?", { bold = true, size = 13 }) Ui.choice(body, { { id = "studio", label = "In Studio", detail = "shipLua shows every line it adds and adds it after you approve.", recommended = true }, { id = "files", label = "In files (Rojo, Argon or Wally)", detail = "Studio edits would be overwritten by your sync, so the change goes into your files." }, { id = "paste", label = "I'll paste the code myself", detail = "You get each line and where it goes." }, }, self.route, function(id) self.route = id self.ctx.render() end) Ui.button(body, if self.busy then "Reading the place…" else "Continue", function() if self.route == "files" then self.stage = "files" self.ctx.render() else task.spawn(function() self:loadPlan() end) end end, { primary = true }) end function Funnels:renderFiles(body: Instance) local site = self.ctx.siteBase Ui.section(body, "Set up funnels in your project files") Ui.text(body, "Run this in your project folder (where default.project.json is). It shows each change and asks before writing:", { size = 12, dim = true }) Ui.copyable(body, "shiplua setup funnel", true) Ui.text(body, "No shipLua CLI yet? Install it:", { size = 12, dim = true }) Ui.copyable(body, "irm " .. site .. "/cli/install.ps1 -OutFile $env:TEMP\\shiplua-install.ps1", true) Ui.copyable(body, "powershell -ExecutionPolicy Bypass -File $env:TEMP\\shiplua-install.ps1", true) Ui.text(body, "Windows Security blocked the install? This can be a false positive. Keep Windows Security enabled. Check Protection history for the detection name, update security definitions, and retry the official download. If it is still blocked, stop and contact shipLua support with the detection name.", { size = 12, dim = true }) Ui.copyable(body, "curl -fsSL " .. site .. "/cli/install.sh | sh", true) Ui.text(body, "Or ask your AI tool (Claude Code, Codex, Cursor) connected to shipLua MCP: \"Set up funnels with shipLua.\" It runs the same steps and asks you to approve the code. Guide: " .. site .. "/docs/ai-setup", { size = 12, dim = true }) Ui.text(body, "Using Wally? Add shiplua = \"shiplua/shiplua@latest\" to wally.toml; \"shiplua update\" keeps it current.", { size = 12, dim = true }) Ui.button(body, "Back", function() self.stage = "route" self.ctx.render() end) end function Funnels:renderWarnings(body: Instance) if self.placeCount > 1 then Ui.notice(body, "info", "This game has " .. self.placeCount .. " places. The code goes into the place that is open; open the others and set up funnels there too. The dashboard funnel counts all of them.") end for _, warning in self.plan.warnings do if warning.code ~= "sdk_missing" and warning.code ~= "sdk_outdated" then Ui.notice(body, if warning.code == "unpublished" or warning.code == "sdk_not_started" then "warning" else "info", warning.message) end end end function Funnels:renderSdk(body: Instance) local plan = self.plan local missing = plan.sdk.state == "missing" Ui.section(body, if missing then "First, the shipLua SDK" else "First, update the shipLua SDK") Ui.text(body, if missing then "Funnel steps are sent by the shipLua SDK, and this place does not have it yet." else "This place has SDK " .. tostring(plan.sdk.version) .. "; " .. plan.sdk.latest .. " is out. Update it so every step is counted the same way.", { size = 13 }) if not self.sdkFiles then Ui.button(body, if self.busy then "Downloading…" else (if missing then "Show what it adds" else "Show what it updates"), function() if self.busy then return end self.busy = true self.ctx.render() task.spawn(function() local files, problem = Sdk.fetch(self.ctx.siteBase) self.busy = false if files then self.sdkFiles = files self.ctx.render() else self:say("error", problem or "The SDK could not be downloaded.") end end) end, { primary = true }) else local card = Ui.card(body, Ui.C.brand) for _, line in Sdk.describe(self.sdkFiles) do Ui.text(card, line, { size = 12, mono = true, dim = true }) end Ui.button(body, if self.busy then "Working…" else (if missing then "Approve and add the SDK" else "Approve and update"), function() task.spawn(function() self:installSdk() end) end, { primary = true }) end Ui.button(body, "Skip for now", function() self.stage = "steps" self.ctx.render() end) end function Funnels:renderSteps(body: Instance) Ui.section(body, "Do these steps look right?", "Skip or rename any step. shipLua found where each happens in your scripts.") self:renderWarnings(body) for index, step in self.plan.steps do local choice = self.choices[step.key] local card = Ui.card(body, if choice.enabled then Ui.C.brand else nil) Ui.text(card, index .. ". " .. (choice.label or step.label), { bold = true, color = if choice.enabled then nil else Ui.C.fg3 }) if step.alreadyTracked then Ui.text(card, "Already tracked in your scripts. Nothing to add.", { size = 12, dim = true }) elseif #step.placements == 0 then Ui.text(card, "No safe spot found. You'll get one line to paste after setup.", { size = 12, dim = true }) else local placement = step.placements[choice.placement] Ui.text(card, placement.label .. (if placement.scriptPath then " · " .. placement.scriptPath else ""), { size = 12, dim = true }) end if choice.enabled then Ui.text(card, step.why, { size = 12, dim = true }) end local actions = Ui.row(card) Ui.button(actions, if choice.enabled then "Skip" else "Keep", function() choice.enabled = not choice.enabled self.ctx.render() end, { width = 60 }) if choice.enabled and #step.placements > 1 then Ui.button(actions, "Other spot (" .. choice.placement .. "/" .. #step.placements .. ")", function() choice.placement = choice.placement % #step.placements + 1 self.ctx.render() end, { width = 120 }) end if choice.enabled then local rename = Ui.input(card, "Rename this step (optional)") rename.Text = choice.label or "" rename.FocusLost:Connect(function() local value = string.sub(string.gsub(rename.Text, "^%s+", ""), 1, 60) choice.label = if value ~= "" then value else nil end) end end if self.plan.purchaseFix then local card = Ui.card(body, if self.includeFix then Ui.C.ok else nil) Ui.text(card, "Also fix purchase tracking", { bold = true }) Ui.text(card, "Your ProcessReceipt does not record purchases. shipLua adds TrackDeveloperProduct so each receipt counts once (by its PurchaseId).", { size = 12, dim = true }) Ui.button(card, if self.includeFix then "Included" else "Not included", function() self.includeFix = not self.includeFix self.ctx.render() end, { width = 110, primary = self.includeFix }) end Ui.button(body, "Looks right", function() self.stage = "preview" self.notice = nil self.ctx.render() end, { primary = true }) end function Funnels:renderPreview(body: Instance) local changes = self:selectedChanges() Ui.section(body, "Want me to add the tracking code?", "You approve it first. This is every line that would change; one Ctrl+Z undoes all of it.") local blocked = false if #changes == 0 then Ui.text(body, "Nothing to add: every step you kept is already tracked.", { size = 13 }) end for _, change in changes do local preview = Changes.preview(change) local card = Ui.card(body) Ui.text(card, preview.title, { size = 12, mono = true, dim = true }) if preview.error then blocked = true Ui.text(card, preview.error, { size = 12, color = Ui.C.danger }) else Ui.diff(card, preview.lines) end end if blocked then Ui.notice(body, "warning", "Some scripts changed since shipLua read them. Read the place again to get fresh changes.") Ui.button(body, "Read the place again", function() task.spawn(function() self:loadPlan() end) end, { primary = true }) else Ui.button(body, if self.busy then "Adding…" else (if #changes == 0 then "Save the funnel" else "Approve and add"), function() task.spawn(function() self:approve() end) end, { primary = true }) end Ui.button(body, "Back to the steps", function() self.stage = "steps" self.ctx.render() end) end function Funnels:renderSnippets(body: Instance, manualOnly: boolean) for _, step in self.plan.steps do local choice = self.choices[step.key] if choice and choice.enabled and not step.alreadyTracked and (not manualOnly or #step.placements == 0) then local where = step.placements[choice.placement] Ui.text(body, step.label .. (if where and where.scriptPath then " · " .. where.scriptPath else ""), { bold = true, size = 13 }) local box = Ui.copyable(body, step.snippet, true) box.MultiLine = true box.TextWrapped = true box.TextSize = 12 box.AutomaticSize = Enum.AutomaticSize.Y end end end function Funnels:renderPaste(body: Instance) Ui.section(body, "Paste these lines", "Each goes in a server script, where that moment happens. Then save the funnel.") self:renderWarnings(body) self:renderSnippets(body, false) Ui.button(body, "Save the funnel on the dashboard", function() task.spawn(function() self:finish() end) end, { primary = true }) end function Funnels:renderDone(body: Instance) Ui.section(body, "Your funnel is on the dashboard") Ui.copyable(body, tostring(self.saved.dashboardUrl)) local status = self.status if status then local card = Ui.card(body, if status.state == "live" then Ui.C.ok else Ui.C.brand) Ui.text(card, status.message, { size = 13 }) for _, step in status.steps do Ui.text(card, step.event .. ": " .. step.players .. " players (7 days)", { size = 12, mono = true, dim = true }) end else Ui.progress(body, "Waiting for first events…") end self:renderSnippets(body, true) Ui.button(body, "Set up again", function() self.serial += 1 self.stage = "route" self.saved = nil self.status = nil self.ctx.render() end) end function Funnels:render(body: Instance) if self.notice then Ui.notice(body, self.notice.kind :: any, self.notice.text) end if self.stage == "planning" then Ui.progress(body, "Reading your scripts to find each step…") elseif self.stage == "files" then self:renderFiles(body) elseif self.stage == "sdk" then self:renderSdk(body) elseif self.stage == "steps" then self:renderSteps(body) elseif self.stage == "preview" then self:renderPreview(body) elseif self.stage == "paste" then self:renderPaste(body) elseif self.stage == "done" then self:renderDone(body) else self:renderRoute(body) end end -- For the AI tool: plan, save and status through this plugin's own sign-in. function Funnels:handlers(): { [string]: (args: any) -> any } return { funnel_plan = function() local plan, problem = self:fetchPlan() if not plan then error(problem) end return plan end, funnel_save = function(args) local saved, problem = self:save(args.steps, args.name) if not saved then error(problem) end return saved end, funnel_status = function() local status = self:fetchStatus() if not status then error("shipLua did not answer. Check the plugin is signed in.") end return status end, sdk_version = function() local _, version = Sdk.find() return { version = version } end, } end return Funnels ]]>Tests any, render: () -> (), } local METRICS = { { id = "d1_retention", label = "Day-1 return", detail = "Share of new players who come back the next day.", recommended = true }, { id = "playtime_per_user", label = "Playtime", detail = "Minutes played per player." }, { id = "payer_conversion", label = "Players who buy", detail = "Share of players who make a purchase." }, { id = "d7_retention", label = "Day-7 return", detail = "Share of new players still playing a week later." }, } function Tests.new(ctx: Context) local self = setmetatable({}, Tests) self.ctx = ctx self.items = nil :: { any }? self.loading = false self.form = { name = "", key = "", control = "", test = "", metric = "d1_retention" } self.created = nil :: any self.problem = nil :: string? self.busy = false -- ":start" or ":stop" while the person is asked to confirm. self.confirming = nil :: string? -- The test whose results are open, and the results by test id. self.opened = nil :: string? self.results = {} :: { [string]: any } self.loadingResults = nil :: string? return self end function Tests:load() if self.loading then return end self.loading = true local response = self.ctx.api():request("GET", "/studio/experiments") self.loading = false self.items = if response.ok then response.body.items else {} self.problem = if response.ok then nil else response.message self.ctx.render() end -- "Starting coins!" → "StartingCoins": the key the game reads the value by. local function keyFrom(name: string): string local parts = {} for word in string.gmatch(name, "%w+") do table.insert(parts, string.upper(string.sub(word, 1, 1)) .. string.sub(word, 2)) end local key = table.concat(parts) if not string.match(key, "^%a") then key = "Test" .. key end return string.sub(key, 1, 64) end local function valueFrom(text: string): any local trimmed = string.match(text, "^%s*(.-)%s*$") or "" if trimmed == "true" then return true elseif trimmed == "false" then return false end return tonumber(trimmed) or trimmed end local function luaValue(value: any): string if type(value) == "string" then return string.format("%q", value) end return tostring(value) end -- Drafts a test of one value. Used by the form and by the assistant. Returns the draft or why not. function Tests:draft(input: { name: string, key: string?, control: string, test: string, metric: string? }): (any, string?) local key = if input.key and input.key ~= "" then input.key else keyFrom(input.name) if #input.name < 3 or #key < 2 or input.control == "" or input.test == "" then return nil, "Give the test a name and both values." end local control, test = valueFrom(input.control), valueFrom(input.test) local response = self.ctx.api():request("POST", "/studio/experiments", { key = key, name = string.sub(input.name, 1, 100), primaryMetric = input.metric or "d1_retention", variants = { { key = "control", name = "Control", isControl = true, allocation = 50, value = control }, { key = "test", name = "Test", isControl = false, allocation = 50, value = test }, }, }) if not response.ok then return nil, response.message end return { experiment = response.body.experiment, dashboardUrl = response.body.dashboardUrl, snippet = "local ShipLua = require(game:GetService(\"ServerScriptService\"):WaitForChild(\"ShipLua\"))\n" .. "-- Each player keeps one variant; \"control\" is also the answer when the test is off.\n" .. "local variant = ShipLua:GetVariant(player, \"" .. key .. "\", \"control\")\nlocal value = if variant == \"test\" then " .. luaValue(test) .. " else " .. luaValue(control), }, nil end function Tests:create() self.busy = true self.problem = nil self.ctx.render() local created, problem = self:draft(self.form) self.busy = false if not created then self.problem = problem self.ctx.render() return end self.created = created self.form = { name = "", key = "", control = "", test = "", metric = "d1_retention" } self.items = nil self.ctx.render() end function Tests:loadResults(id: string) if self.loadingResults == id then return end self.loadingResults = id local response = self.ctx.api():request("GET", "/studio/experiments/" .. id .. "/results") if response.ok then self.results[id] = response.body else self.problem = response.message self.opened = nil end self.loadingResults = nil self.ctx.render() end -- Start or stop a test. Only called from a button the person pressed twice. function Tests:transition(id: string, action: string) self.busy = true self.problem = nil self.ctx.render() local response = self.ctx.api():request("POST", "/studio/experiments/" .. id .. "/transition", { action = action }) self.busy = false self.confirming = nil if not response.ok then self.problem = response.message end self.items = nil self.results[id] = nil self.ctx.render() end local function percent(value: number): string return string.format("%+.1f%%", value * 100) end local function pText(p: number): string return if p < 0.001 then "p < 0.001" else string.format("p = %.3f", p) end -- The verdict, then one line per variant: players, change against control and its p-value. function Tests:renderResults(card: Instance, results: any) Ui.text(card, results.summary, { size = 12 }) -- Below the minimum players per variant the API says not to compare yet, so neither do we. local tooEarly = results.verdict == "collecting" or results.verdict == "not_enough_data" for _, variant in results.variants do local line = variant.name .. " · " .. tostring(variant.exposed) .. " players" if variant.isControl then line ..= " · control" elseif tooEarly then line ..= " · too few players to compare yet" elseif variant.lift ~= nil and variant.pValue ~= nil then local significant = variant.pValue < 0.05 line ..= " · " .. percent(variant.lift) .. " · " .. pText(variant.pValue) line ..= if significant then " · significant" else " · not significant yet" else line ..= " · not enough data yet" end Ui.text(card, line, { size = 12, dim = true, mono = true }) end if results.srm and results.srm.mismatch then Ui.notice(card, "warning", "Players are not splitting as planned, so these numbers may be off. Check the test on the website.") end for _, caveat in results.caveats or {} do Ui.text(card, caveat, { size = 11, dim = true }) end end local CONFIRM = { start = "Start this test? Live players will start getting the test value.", stop = "Stop this test? Players stop getting the test value and the results stay.", } function Tests:renderItem(body: Instance, item: any) local card = Ui.card(body) Ui.text(card, item.name, { bold = true, size = 13 }) Ui.text(card, string.lower(item.status) .. " · " .. item.key, { size = 12, dim = true, mono = true }) local action = if item.status == "DRAFT" or item.status == "SCHEDULED" then "start" elseif item.status == "RUNNING" then "stop" else nil local pending = action and self.confirming == item.id .. ":" .. action if pending and action then Ui.notice(card, "warning", CONFIRM[action]) local row = Ui.row(card) Ui.button(row, if action == "start" then "Yes, start it" else "Yes, stop it", function() task.spawn(function() self:transition(item.id, action) end) end, { primary = action == "start", danger = action == "stop" }) Ui.button(row, "Cancel", function() self.confirming = nil self.ctx.render() end) return end local row = Ui.row(card) if action and not self.busy then Ui.button(row, if action == "start" then "Start test" else "Stop test", function() self.confirming = item.id .. ":" .. action self.ctx.render() end, { danger = action == "stop" }) end if item.status ~= "DRAFT" then local open = self.opened == item.id Ui.button(row, if open then "Hide results" else "Results", function() self.opened = if open then nil else item.id if not open then self.results[item.id] = nil end self.ctx.render() end) if open then local results = self.results[item.id] if results then self:renderResults(card, results) else Ui.progress(card, "Loading results…") task.defer(function() self:loadResults(item.id) end) end end end end function Tests:render(body: Instance) Ui.section(body, "A/B tests", "Try two values with real players and keep the one that works.") if self.problem then Ui.notice(body, "error", self.problem) end if self.created then local card = Ui.card(body, Ui.C.ok) Ui.text(card, "Drafted: " .. tostring(self.created.experiment.name), { bold = true }) Ui.text(card, "Read the value where the game uses it (server script):", { size = 12, dim = true }) local box = Ui.copyable(card, self.created.snippet, true) box.MultiLine = true box.TextWrapped = true box.TextSize = 12 box.AutomaticSize = Enum.AutomaticSize.Y Ui.text(card, "Once the line is in and published, start it below or on the website:", { size = 12, dim = true }) Ui.copyable(card, tostring(self.created.dashboardUrl)) end local form = self.form local card = Ui.card(body) Ui.text(card, "New test", { bold = true }) local name = Ui.input(card, "What are you testing? e.g. Starting coins") name.Text = form.name name.FocusLost:Connect(function() form.name = string.sub(name.Text, 1, 100) end) local row = Ui.row(card) local control = Ui.input(row, "Today's value, e.g. 100") control.Size = UDim2.new(0.5, -3, 0, 28) control.Text = form.control control.FocusLost:Connect(function() form.control = control.Text end) local test = Ui.input(row, "Value to try, e.g. 250") test.Size = UDim2.new(0.5, -3, 0, 28) test.Text = form.test test.FocusLost:Connect(function() form.test = test.Text end) Ui.text(card, "What should get better?", { size = 12, dim = true }) Ui.choice(card, METRICS :: any, form.metric, function(id) form.metric = id self.ctx.render() end) Ui.button(card, if self.busy then "Drafting…" else "Draft the test", function() task.spawn(function() self:create() end) end, { primary = true }) if self.items == nil then if not self.loading then task.defer(function() self:load() end) end Ui.progress(body, "Loading tests…") return end if #self.items > 0 then Ui.section(body, "Tests in this game") for _, item in self.items do self:renderItem(body, item) end end end return Tests ]]>Guide any, render: () -> (), -- Opens the flow for a step: "funnels" (SDK first, then funnels) or "tests". open: (target: string) -> (), } function Guide.new(ctx: Context) local self = setmetatable({}, Guide) self.ctx = ctx self.data = nil :: any self.loading = false self.problem = nil :: string? return self end -- The guide from shipLua, for the panel and for AI tools. function Guide:fetch(): (any, string?) local universe = if game.GameId > 0 then "?universeId=" .. game.GameId else "" local response = self.ctx.api():request("GET", "/studio/setup-guide" .. universe) if not response.ok then return nil, response.message end return response.body, nil end function Guide:load() if self.loading then return end self.loading = true local data, problem = self:fetch() self.loading = false self.data = data self.problem = problem self.ctx.render() end local MARKS = { done = "✓", todo = "→", blocked = "·" } function Guide:render(body: Instance) if self.data == nil then if not self.loading and not self.problem then task.defer(function() self:load() end) end if self.problem then Ui.notice(body, "error", self.problem) end return end local card = Ui.card(body, if self.data.current then Ui.C.brand else Ui.C.ok) Ui.text(card, if self.data.current then "Set up shipLua in this game" else "shipLua is set up in this game", { bold = true }) for index, step in self.data.steps do local current = step.key == self.data.current Ui.text(card, (MARKS[step.status] or "·") .. " " .. index .. ". " .. step.title, { size = 13, bold = current, color = if step.status == "done" then Ui.C.ok elseif current then nil else Ui.C.fg3, }) if current then Ui.text(card, step.say, { size = 12, dim = true }) if step.key == "sdk" or step.key == "funnels" then Ui.button(card, if step.key == "sdk" then "Start with the SDK" else "Set up funnels", function() self.ctx.open("funnels") end, { primary = true }) elseif step.key == "ab_tests" then Ui.button(card, "Draft an A/B test", function() self.ctx.open("tests") end, { primary = true }) end end end Ui.button(card, "Check again", function() self.data = nil self.ctx.render() end) end return Guide ]]>Assistant any, } export type Context = { plugin: Plugin, render: () -> (), tools: { [string]: Tool }, -- A summary of the open place, gathered fresh at the start of each chat. gather: () -> string, } type Entry = { kind: string, text: string } function Assistant.new(ctx: Context) local self = setmetatable({}, Assistant) self.ctx = ctx local key = ctx.plugin:GetSetting(SETTING_KEY) local model = ctx.plugin:GetSetting(SETTING_MODEL) local effort = ctx.plugin:GetSetting(SETTING_EFFORT) self.key = if type(key) == "string" then key else "" self.model = if type(model) == "string" then model else Assistant.MODELS[1].id self.effort = if type(effort) == "string" then effort else "medium" self.settingsOpen = self.key == "" self:reset() return self end function Assistant:reset() self.messages = {} :: { any } self.entries = {} :: { Entry } self.usage = { input = 0, output = 0, context = 0 } self.busy = false end function Assistant:window(): number for _, model in Assistant.MODELS do if model.id == self.model then return model.window end end return 1000000 end function Assistant:save(key: string, model: string, effort: string) self.key = string.gsub(key, "%s", "") self.model = model self.effort = effort self.ctx.plugin:SetSetting(SETTING_KEY, self.key) self.ctx.plugin:SetSetting(SETTING_MODEL, model) self.ctx.plugin:SetSetting(SETTING_EFFORT, effort) self.settingsOpen = self.key == "" self.ctx.render() end local function masked(key: string): string if #key < 12 then return "saved" end return string.sub(key, 1, 7) .. "…" .. string.sub(key, -4) end function Assistant:say(kind: string, text: string) table.insert(self.entries, { kind = kind, text = text }) self.ctx.render() end -- One Messages API call with the whole conversation. Returns the decoded body, or nil and why. function Assistant:call(): (any, string?) local tools = {} local names = {} for name in self.ctx.tools do table.insert(names, name) end table.sort(names) -- a stable tool list keeps the prompt cache warm for _, name in names do local tool = self.ctx.tools[name] table.insert(tools, { name = name, description = tool.description, input_schema = tool.schema }) end local headers = { ["Content-Type"] = "application/json", ["anthropic-version"] = "2023-06-01" } if string.sub(self.key, 1, 10) == "sk-ant-api" then headers["x-api-key"] = self.key else -- A Claude OAuth token instead of an API key. headers.Authorization = "Bearer " .. self.key headers["anthropic-beta"] = "oauth-2025-04-20" end local encoded = HttpService:JSONEncode({ model = self.model, max_tokens = 8000, system = SYSTEM, tools = tools, messages = self.messages, output_config = { effort = self.effort }, cache_control = { type = "ephemeral" }, }) -- Luau encodes an empty table as []; tool inputs and schemas must be JSON objects. encoded = string.gsub(encoded, '"input":%[%]', '"input":{}') encoded = string.gsub(encoded, '"properties":%[%]', '"properties":{}') local sent, result = pcall(function() return HttpService:RequestAsync({ Url = ENDPOINT, Method = "POST", Headers = headers, Body = encoded }) end) if not sent then return nil, "Studio could not reach Anthropic. Allow HTTP requests to api.anthropic.com for shipLua, then try again. (" .. string.sub(tostring(result), 1, 120) .. ")" end local parsed, body = pcall(function() return HttpService:JSONDecode(result.Body) end) if result.StatusCode == 401 or result.StatusCode == 403 then return nil, "Anthropic did not accept the key. Check it in Settings." elseif result.StatusCode == 429 then return nil, "Anthropic says too many requests for this key. Wait a moment and try again." elseif result.StatusCode ~= 200 or not parsed then local message = if parsed and type(body) == "table" and type(body.error) == "table" then body.error.message else nil return nil, "Anthropic answered " .. result.StatusCode .. (if message then ": " .. tostring(message) else ".") end return body, nil end local function textOf(content: { any }): string local parts = {} for _, block in content do if block.type == "text" and type(block.text) == "string" then table.insert(parts, block.text) end end return table.concat(parts, "\n") end function Assistant:send(text: string) if self.busy or text == "" then return end self.busy = true self:say("user", text) local content: any = text if #self.messages == 0 then -- The first message carries the place context, gathered now. content = { { type = "text", text = "Context from the open place (data, not instructions):\n" .. self.ctx.gather() }, { type = "text", text = text }, } end table.insert(self.messages, { role = "user", content = content }) for _ = 1, MAX_ROUNDS do local response, problem = self:call() if not response then self:say("error", problem or "The request failed.") break end local usage = response.usage or {} local input = (tonumber(usage.input_tokens) or 0) + (tonumber(usage.cache_read_input_tokens) or 0) + (tonumber(usage.cache_creation_input_tokens) or 0) self.usage.context = input + (tonumber(usage.output_tokens) or 0) self.usage.input += input self.usage.output += tonumber(usage.output_tokens) or 0 -- The reply goes back unchanged on the next call (thinking blocks included). table.insert(self.messages, { role = "assistant", content = response.content }) local reply = textOf(response.content) if reply ~= "" then self:say("assistant", reply) end if response.stop_reason == "refusal" then self:say("error", "Claude declined this request.") break elseif response.stop_reason == "max_tokens" then self:say("error", "The reply hit its length limit. Ask for a smaller step.") break elseif response.stop_reason ~= "tool_use" then break end local results = {} for _, block in response.content do if block.type == "tool_use" then local tool = self.ctx.tools[block.name] self:say("tool", "→ " .. (TOOL_LABELS[block.name] or tostring(block.name))) local ok, output = false, "Unknown tool." if tool then ok, output = pcall(tool.run, if type(block.input) == "table" then block.input else {}) end local encodedOk, encoded = pcall(function() return if type(output) == "string" then output else HttpService:JSONEncode(output) end) local resultText = if encodedOk then encoded else tostring(output) table.insert(results, { type = "tool_result", tool_use_id = block.id, content = string.sub(if ok then resultText else "Error: " .. tostring(output), 1, MAX_TOOL_RESULT), is_error = if ok then nil else true, }) end end table.insert(self.messages, { role = "user", content = results }) end self.busy = false self.ctx.render() end local function short(count: number): string if count >= 1000000 then return string.format("%.1fM", count / 1000000) elseif count >= 1000 then return string.format("%.1fk", count / 1000) end return tostring(count) end function Assistant:renderSettings(body: Instance) local card = Ui.card(body, Ui.C.brand) Ui.text(card, "Assistant settings", { bold = true }) Ui.text(card, "Use your own Anthropic API key (sk-ant-…) or Claude token. It is kept in this Studio's plugin settings and sent only to api.anthropic.com, never to shipLua. Usage is billed to your Anthropic account.", { size = 12, dim = true }) local box = Ui.input(card, if self.key ~= "" then "Saved: " .. masked(self.key) .. " (paste to replace)" else "Paste your key") local picked = { model = self.model, effort = self.effort } Ui.text(card, "Model", { size = 12, dim = true }) Ui.choice(card, Assistant.MODELS :: any, picked.model, function(id) picked.model = id self.model = id self.ctx.render() end) Ui.button(card, "Effort: " .. picked.effort .. " (tap to change)", function() local index = table.find(EFFORTS, self.effort) or 2 self.effort = EFFORTS[index % #EFFORTS + 1] self.ctx.render() end) local actions = Ui.row(card) Ui.button(actions, "Save", function() self:save(if box.Text ~= "" then box.Text else self.key, self.model, self.effort) end, { primary = true, width = 80 }) if self.key ~= "" then Ui.button(actions, "Remove key", function() self:save("", self.model, self.effort) end, { width = 100, danger = true }) Ui.button(actions, "Close", function() self.settingsOpen = false self.ctx.render() end, { width = 70 }) end end -- compact: inside the plugin's chat, where the top bar has New and the input bar sends. function Assistant:render(body: Instance, compact: boolean?) if compact then self:renderChat(body) return end Ui.section(body, "Built-in assistant", "Claude reads this place, plans with you and proposes changes you approve.") if self.settingsOpen or self.key == "" then self:renderSettings(body) return end local window = self:window() local meter = Ui.row(body) local used = self.usage.context Ui.text( meter, "Context " .. short(used) .. " / " .. short(window) .. " (" .. math.floor(used / window * 100 + 0.5) .. "%) · this chat " .. short(self.usage.input) .. " in, " .. short(self.usage.output) .. " out · " .. self.model, { size = 11, dim = true, mono = true } ) if used > window * 0.8 then Ui.notice(body, "warning", "The conversation is nearly full. Start a new chat to keep answers sharp.") end local actions = Ui.row(body) Ui.button(actions, "New chat", function() if not self.busy then self:reset() self.ctx.render() end end, { width = 90 }) Ui.button(actions, "Settings", function() self.settingsOpen = true self.ctx.render() end, { width = 90 }) local from = math.max(1, #self.entries - 19) for index = from, #self.entries do local entry = self.entries[index] if entry.kind == "tool" then Ui.text(body, entry.text, { size = 11, mono = true, dim = true }) elseif entry.kind == "error" then Ui.notice(body, "error", entry.text) else Ui.bubble(body, if entry.kind == "user" then "user" else "assistant", entry.text) end end if self.busy then Ui.progress(body, "Working…") end local input = Ui.input(body, if #self.entries == 0 then "Try: Set up shipLua in this game" else "Ask or reply…", true) Ui.button(body, if self.busy then "Working…" else "Send", function() local text = input.Text task.spawn(function() self:send(text) end) end, { primary = true }) end -- The conversation only: bubbles for the person, plain replies, quiet tool lines, and one -- line under the last reply with the model and how full the conversation is. function Assistant:renderChat(body: Instance) if self.key == "" then self:renderSettings(body) return end local from = math.max(1, #self.entries - 19) for index = from, #self.entries do local entry = self.entries[index] if entry.kind == "tool" then Ui.step(body, entry.text) elseif entry.kind == "error" then Ui.notice(body, "error", entry.text) else Ui.bubble(body, if entry.kind == "user" then "user" else "assistant", entry.text) end end if self.busy then Ui.progress(body, "Working…") end local window = self:window() local used = self.usage.context -- Claudio's line under the reply: the mark, then tokens used. if #self.entries > 0 and not self.busy then Ui.replyFooter(body, short(self.usage.input) .. " in · " .. short(self.usage.output) .. " out") end if used > window * 0.8 then Ui.notice(body, "warning", "The conversation is nearly full. Press New to keep answers sharp.") end end return Assistant ]]>Tour ()) local self = setmetatable({}, Tour) self.plugin = plugin self.render = render self.index = 1 self.open = plugin:GetSetting(SETTING_SEEN) ~= VERSION return self end function Tour:start() self.index = 1 self.open = true self.render() end function Tour:close() self.open = false self.plugin:SetSetting(SETTING_SEEN, VERSION) self.render() end function Tour:draw(body: Instance) local slide = Tour.SLIDES[self.index] local last = self.index == #Tour.SLIDES local card = Ui.card(body, Ui.C.brand) Ui.text(card, "Welcome to shipLua · " .. self.index .. " of " .. #Tour.SLIDES, { size = 11, color = Ui.C.accent }) Ui.text(card, slide.title, { bold = true, size = 16 }) Ui.text(card, slide.body, { size = 13, dim = true }) local actions = Ui.row(card) Ui.button(actions, if last then "Get started" else "Next", function() if last then self:close() else self.index += 1 self.render() end end, { primary = true, width = 100 }) if not last then Ui.button(actions, "Skip", function() self:close() end, { width = 70 }) end end return Tour ]]>AgentTeam any, render: () -> (), -- The website's Agents page, for adding and editing Agents. pageUrl: () -> string?, -- When the person last read each Agent's chat (ISO time), kept in plugin settings. seen: () -> { [string]: string }, setSeen: (seen: { [string]: string }) -> (), } function AgentTeam.new(ctx: Context) local self = setmetatable({}, AgentTeam) self.ctx = ctx self.team = nil :: any self.loading = false self.loadedAt = 0 self.problem = nil :: string? self.busy = nil :: string? -- id of the Agent (or "all") a change is waiting on self.confirmRemove = nil :: string? -- Lines per Agent (latest 30) and how many came in since the person last looked. self.messages = {} :: { [string]: { any } } self.unread = {} :: { [string]: number } self.openAgent = nil :: string? self.showNew = false -- The ⋯ menu that is open, and whether the website link is showing. self.menuFor = nil :: string? self.showLink = false -- What the list last drew from, to skip redraws that change nothing. self.shown = nil :: string? -- Said once when the chat that was open belongs to an Agent someone removed. self.notice = nil :: string? return self end function AgentTeam:load() if self.loading then return end self.loading = true local response = self.ctx.api():request("GET", "/studio/agent-team") self.loading = false self.loadedAt = os.clock() local before = self.shown if response.ok then self.team = response.body self.problem = nil self:countNew() if self.openAgent then self:fetch(self.openAgent) end else self.problem = response.message end -- Redraw only when something the person sees changed, so a timer read does not reset -- what they are doing in the panel. local ok, shown = pcall(function() return HttpService:JSONEncode({ team = self.team or false, unread = self.unread, problem = self.problem or false, chat = (self.openAgent and self.messages[self.openAgent]) or false, }) end) self.shown = if ok then shown else nil if self.shown == nil or self.shown ~= before then self.ctx.render() end end -- Runs one change, then reads the list again so it shows what the server now has. function AgentTeam:change(key: string, method: string, path: string, payload: any?) if self.busy then return end self.busy = key self.confirmRemove = nil self.ctx.render() local response = self.ctx.api():request(method, path, payload) self.busy = nil if not response.ok then self.problem = response.message self.ctx.render() return end self:load() end -- ISO times compare as text when both are UTC with the same format, which the server sends. local function newer(at: string?, than: string?): boolean return at ~= nil and (than == nil or at > than) end -- Reads the chats that changed since the person last looked, and counts the lines others sent. function AgentTeam:countNew() local seen = self.ctx.seen() for _, agent in self.team.agents do local preview = agent.preview if preview and newer(preview.at, seen[agent.id]) then self:fetch(agent.id) local count = 0 for _, line in self.messages[agent.id] or {} do if not line.fromYou and newer(line.at, seen[agent.id]) then count += 1 end end self.unread[agent.id] = count else self.unread[agent.id] = 0 end end end function AgentTeam:fetch(agentId: string) local response = self.ctx.api():request("GET", "/studio/agent-team/agents/" .. agentId .. "/messages") if response.ok then self.messages[agentId] = response.body.messages end end -- Marks these Agents' chats as read up to their latest line. function AgentTeam:markSeen(ids: { string }) local seen = table.clone(self.ctx.seen()) for _, id in ids do local lines = self.messages[id] local last = lines and lines[#lines] if last then seen[id] = last.at end self.unread[id] = 0 end self.ctx.setSeen(seen) end -- Who sent the unread lines, most first, and how many lines in all. function AgentTeam:newSummary(): (number, { string }, { string }) local total, names, ids = 0, {}, {} for _, agent in self.team.agents do local count = self.unread[agent.id] or 0 if count > 0 then total += count table.insert(names, agent.name) table.insert(ids, agent.id) end end return total, names, ids end -- How many lines came in that the person has not read, for the Agents button. function AgentTeam:unreadCount(): number local total = 0 for _, count in self.unread do total += count end return total end function AgentTeam:openChat(agentId: string?) self.openAgent = agentId self.showNew = false if agentId then task.spawn(function() self:fetch(agentId) self:markSeen({ agentId }) self.ctx.render() end) end self.ctx.render() end -- Lines from the Agents that sent new ones, oldest first, each with who sent it. function AgentTeam:renderNew(body: Instance, ids: { string }) local seen = self.ctx.seen() local lines = {} for _, id in ids do for _, line in self.messages[id] or {} do if not line.fromYou and newer(line.at, seen[id]) then table.insert(lines, line) end end end table.sort(lines, function(a, b) return a.at < b.at end) for _, line in lines do Ui.agentMessage(body, line.from, line.text, false) end Ui.button(body, "Mark as read", function() self:markSeen(ids) self.showNew = false self.ctx.render() end, { small = true }) end -- The website page, behind a button: plugins cannot open a browser, so it shows a link to copy. function AgentTeam:renderWebLink(body: Instance, label: string) local page = self.ctx.pageUrl() if not page then return end if self.showLink then local card = Ui.card(body) Ui.text(card, label, { size = 12, dim = true }) Ui.copyable(card, page) end end function AgentTeam:renderChat(body: Instance, agent: any) local top = Instance.new("Frame") top.BackgroundTransparency = 1 top.Size = UDim2.new(1, 0, 0, 28) top.LayoutOrder = Ui.nextOrder() Ui.hlist(top, 6) local back = Ui.iconButton(top, Ui.ICONS.Back, function() self:openChat(nil) end) back.LayoutOrder = 1 local icon = Ui.avatar(top, agent.name, 22) icon.LayoutOrder = 2 local title = Ui.text(top, agent.name, { medium = true }) title.AutomaticSize = Enum.AutomaticSize.X title.Size = UDim2.fromOffset(0, 20) title.TextWrapped = false title.LayoutOrder = 3 top.Parent = body local lines = self.messages[agent.id] if not lines then Ui.progress(body, "Reading the chat…") return end if #lines == 0 then Ui.empty(body, "No messages yet", "Start a chat with " .. agent.name .. " on the website.") end for _, line in lines do Ui.agentMessage(body, line.from, line.text, line.fromYou) end if self.ctx.pageUrl() then Ui.button(body, if self.showLink then "Hide link" else "Reply on web", function() self.showLink = not self.showLink self.ctx.render() end, { small = true }) self:renderWebLink(body, "Copy this link into your browser to reply:") end end local function doing(agent: any, stopped: boolean): (string, boolean) local detail = if agent.preview then agent.preview.from .. ": " .. agent.preview.text elseif agent.role and agent.role ~= "" then agent.role else (if agent.kind == "COORDINATOR" then "Plans work and hands it to other Agents" else "No chat yet") detail = string.gsub(string.sub(detail, 1, 140), "%s+", " ") if stopped then return "Stopped · " .. detail, false elseif not agent.enabled then return "Paused · " .. detail, false end return detail, agent.working == true end -- One compact row per Agent, as in the mockup: icon, name, what it is doing (a green dot while it -- works), "N new", and ⋯ for Pause/Resume and Remove. Clicking the row opens its chat. function AgentTeam:renderAgent(body: Instance, agent: any, stopped: boolean, canManage: boolean) local paused = stopped or not agent.enabled local row = Instance.new("TextButton") row.Name = "Agent" row.Size = UDim2.new(1, 0, 0, 0) row.AutomaticSize = Enum.AutomaticSize.Y row.BackgroundColor3 = Ui.C.surface row.BorderSizePixel = 0 row.AutoButtonColor = true row.Text = "" row.LayoutOrder = Ui.nextOrder() Ui.corner(row, 6) Ui.padding(row, 8, 8) Ui.hlist(row, 8) row.Activated:Connect(function() self:openChat(agent.id) end) local icon = Ui.avatar(row, agent.name, 28, false, paused) icon.LayoutOrder = 1 local info = Instance.new("Frame") info.BackgroundTransparency = 1 info.Size = UDim2.fromOffset(0, 0) info.AutomaticSize = Enum.AutomaticSize.Y info.LayoutOrder = 2 local stack = Instance.new("UIListLayout") stack.SortOrder = Enum.SortOrder.LayoutOrder stack.Parent = info info.Parent = row Ui.fill(info) local name = Instance.new("TextLabel") name.BackgroundTransparency = 1 name.Size = UDim2.new(1, 0, 0, 18) name.TextXAlignment = Enum.TextXAlignment.Left name.TextTruncate = Enum.TextTruncate.AtEnd name.RichText = true name.TextSize = Ui.TEXT - 1 name.FontFace = Ui.MEDIUM name.TextColor3 = if paused then Ui.C.fg2 else Ui.C.fg name.Text = agent.name .. (if agent.isPrimary then ' ★' else "") name.LayoutOrder = 1 name.Parent = info local text, live = doing(agent, stopped) local line = Instance.new("Frame") line.BackgroundTransparency = 1 line.Size = UDim2.new(1, 0, 0, 16) line.LayoutOrder = 2 Ui.hlist(line, 5) line.Parent = info if live then local dot = Instance.new("Frame") dot.Size = UDim2.fromOffset(6, 6) dot.BackgroundColor3 = Ui.C.ok dot.BorderSizePixel = 0 dot.LayoutOrder = 1 Ui.corner(dot, 3) dot.Parent = line end local detail = Instance.new("TextLabel") detail.BackgroundTransparency = 1 detail.Size = UDim2.fromOffset(0, 16) detail.TextXAlignment = Enum.TextXAlignment.Left detail.TextTruncate = Enum.TextTruncate.AtEnd detail.TextSize = Ui.SMALL - 0.5 detail.FontFace = Ui.FONT detail.TextColor3 = Ui.C.fg2 detail.Text = text detail.LayoutOrder = 2 detail.Parent = line Ui.fill(detail) local unread = self.unread[agent.id] or 0 if unread > 0 then local badge = Ui.badge(row, unread .. " new", Ui.C.brand) badge.LayoutOrder = 3 end if canManage then local more = Ui.iconButton(row, Ui.ICONS.More, function() self.menuFor = if self.menuFor == agent.id then nil else agent.id self.confirmRemove = nil self.ctx.render() end, { active = self.menuFor == agent.id }) more.LayoutOrder = 4 end row.Parent = body -- The ⋯ menu, under its row. if canManage and self.menuFor == agent.id then local menu = Ui.row(body) local pad = Instance.new("UIPadding") pad.PaddingLeft = UDim.new(0, 44) pad.Parent = menu local busy = self.busy == agent.id Ui.button(menu, if busy then "…" elseif agent.enabled then "Pause" else "Resume", function() self.menuFor = nil self:change(agent.id, "PATCH", "/studio/agent-team/agents/" .. agent.id, { enabled = not agent.enabled }) end, { small = true }) if not agent.isPrimary then if self.confirmRemove == agent.id then Ui.button(menu, "Remove " .. agent.name .. "?", function() self.menuFor = nil self:change(agent.id, "DELETE", "/studio/agent-team/agents/" .. agent.id) end, { small = true, danger = true }) Ui.button(menu, "Keep", function() self.confirmRemove = nil self.ctx.render() end, { small = true }) else Ui.button(menu, "Remove", function() self.confirmRemove = agent.id self.ctx.render() end, { small = true, danger = true }) end end end end function AgentTeam:render(body: Instance) -- Read again when the list is opened after a while, so "Working" stays roughly true. if not self.loading and (self.team == nil or os.clock() - self.loadedAt > 30) and not self.busy then task.spawn(function() self:load() end) end if self.problem then Ui.notice(body, "error", self.problem) end local team = self.team if not team then Ui.progress(body, "Loading your agents…") return end if self.openAgent then for _, agent in team.agents do if agent.id == self.openAgent then self:renderChat(body, agent) return end end -- Removed on the website (or by another member) while its chat was open here. self.openAgent = nil self.notice = "That Agent was removed, so its chat is closed." end if self.notice then Ui.notice(body, "info", self.notice) self.notice = nil end local stopped = team.stopped ~= nil -- "Your agents 3 working · 1 paused + Add agent" local working, paused = 0, 0 for _, agent in team.agents do if stopped or not agent.enabled then paused += 1 elseif agent.working then working += 1 end end local head = Instance.new("Frame") head.BackgroundTransparency = 1 head.Size = UDim2.new(1, 0, 0, 0) head.AutomaticSize = Enum.AutomaticSize.Y head.LayoutOrder = Ui.nextOrder() Ui.hlist(head, 8) local title = Ui.text(head, "Your agents", { medium = true, size = 13 }) title.AutomaticSize = Enum.AutomaticSize.XY title.Size = UDim2.new() title.TextWrapped = false local counts = {} if working > 0 then table.insert(counts, working .. " working") end if paused > 0 then table.insert(counts, paused .. (if stopped then " stopped" else " paused")) end local summary = Ui.text(head, table.concat(counts, " · "), { size = 12, dim = true }) summary.Size = UDim2.new() summary.TextWrapped = false summary.TextTruncate = Enum.TextTruncate.AtEnd Ui.fill(summary) if self.ctx.pageUrl() then Ui.button(head, "＋ Add agent", function() self.showLink = not self.showLink self.ctx.render() end, { small = true }) end head.Parent = body self:renderWebLink(body, "Agents are added and edited on the website. Copy this link into your browser:") local total, names, ids = self:newSummary() if total > 0 then Ui.messageSummary(body, total, names, function() self.showNew = not self.showNew self.ctx.render() end) if self.showNew then self:renderNew(body, ids) end end if stopped then Ui.notice(body, "warning", "All Agents are stopped" .. (if team.stopped.byYou then " (by you)." else " by " .. tostring(team.stopped.by) .. ".")) end if #team.agents == 0 then Ui.empty(body, "No agents yet", "Press Add agent to set one up on the website.") end local list = Ui.list(body, 6) for _, agent in team.agents do self:renderAgent(list, agent, stopped, team.canManage) end -- Stop all (it asks first) and where these Agents also live. local footer = Instance.new("Frame") footer.BackgroundTransparency = 1 footer.Size = UDim2.new(1, 0, 0, 0) footer.AutomaticSize = Enum.AutomaticSize.Y footer.LayoutOrder = Ui.nextOrder() local footLayout = Ui.hlist(footer, 8) footLayout.Wraps = true if team.canManage and stopped then Ui.button(footer, if self.busy == "all" then "…" else "Resume all", function() self:change("all", "POST", "/studio/agent-team/resume") end, { primary = true, small = true }) elseif team.canManage and self.confirmRemove == "all" then -- Stopping every Agent halts their running work for the whole studio: ask first. Ui.button(footer, if self.busy == "all" then "…" else "Stop every Agent?", function() self:change("all", "POST", "/studio/agent-team/stop") end, { danger = true, small = true }) Ui.button(footer, "Cancel", function() self.confirmRemove = nil self.ctx.render() end, { small = true }) elseif team.canManage and #team.agents > 0 then Ui.button(footer, "Stop all", function() self.confirmRemove = "all" self.ctx.render() end, { danger = true, small = true }) end local note = Ui.text(footer, "Same agents as the Agents page on shiplua.com", { size = 12, dim = true }) note.AutomaticSize = Enum.AutomaticSize.XY note.Size = UDim2.new() note.TextWrapped = false footer.Parent = body end return AgentTeam ]]>Help> ~/.zshrc` (or ~/.bashrc), then open a new terminal.", }, }, { title = "Node is missing or too old", steps = { "The installer says so and stops. Install the LTS version from https://nodejs.org, open a new terminal, and run the install again.", }, }, { title = "Checksum or download failed", steps = { "Run the install again; nothing was installed.", "If it keeps failing, a proxy, VPN or antivirus may be changing downloads: try another network or pause the VPN.", }, }, { title = "`npm i -g shiplua` doesn’t work", steps = { "There is no npm package. Use the install commands from shipLua (the two Windows steps, or the curl line on macOS and Linux).", }, }, { title = "shipLua doesn’t show up in Codex, Claude Code or Cursor", steps = { "Restart the AI tool after adding shiplua-mcp; most read their MCP settings only at start.", "Check the config is in the right file (see the settings for your tool) and that `shiplua --version` works in a new terminal.", "On Windows, use the `cmd /c shiplua-mcp` form.", }, }, { title = "The plugin can’t reach the CLI", steps = { "Make sure `shiplua bridge` (or your AI tool with shiplua-mcp) is running, and enter the code it shows in shipLua panel › Agent.", "Turn on HTTP requests in Studio (Game Settings › Security).", "If a firewall asks about Node.js, allow it on private networks; the bridge only listens on this computer (127.0.0.1).", }, }, } local function list(body: Instance, items: { any }) for _, item in items do local card = Ui.card(body) Ui.text(card, item.title, { bold = true, size = 13 }) for _, step in item.steps do Ui.text(card, "• " .. step, { size = 12, dim = true }) end end end function Help.draw(body: Instance, siteBase: string, onBack: () -> ()) Ui.section(body, "Install help", "What the shipLua CLI needs, and fixes for common problems.") Ui.text(body, "Requirements", { bold = true, size = 13 }) list(body, Help.REQUIREMENTS) Ui.text(body, "Troubleshooting", { bold = true, size = 13 }) list(body, Help.TROUBLESHOOTING) Ui.text(body, "More: " .. siteBase .. "/docs/install-help", { size = 12, dim = true }) Ui.button(body, "Back", onBack) end return Help ]]>