Let the install set how many steps a run may take

The two limits were compiled in: a task run stopped at
AppData.HarnessMaxToolSteps (200) and a chat reply at
AppData.BotReplyMaxToolSteps (8), so an install that needed a longer task
had to rebuild.

Both are now `app_settings` rows (`harness_max_tool_steps` and
`bot_reply_max_tool_steps`), read at the two loop call sites through
grabHarnessMaxToolSteps and grabReplyMaxToolSteps, and edited by the super
admin on Settings > General beside the prompt appendix. Zero clears a
limit back to the code default, like the bot file quota.

readStepLimit keeps the saved number only when it is a whole number of at
least 1 and no more than AppData.BotStepLimitMax (1000), so a blank, a
zero or a typo falls back instead of stopping every run before its first
turn, and a huge number still ends in the wrap-up report.

runTextLoop keeps AppData.HarnessMaxToolSteps as its default, so it stays
free of database reads and its tests run as they did.
This commit is contained in:
2026-10-23 16:20:38 +01:00
parent 06586a6dc8
commit 024d847b9a
16 changed files with 420 additions and 5 deletions
@@ -5,6 +5,7 @@ import sanitizeUserBio from "@/src/functions/backend/db/users/sanitize-user-bio"
import grabUserPasswordHash from "@/src/functions/backend/auth/grab-user-password-hash";
import type { PagePropsType } from "@/src/types";
import type { BunextPageServerFn } from "@moduletrace/bunext/types";
import grabRunLimitsOverview from "@/src/functions/backend/db/app-settings/grab-run-limits";
import grabStorageQuotaOverview from "@/src/functions/backend/db/app-settings/grab-storage-quota-overview";
import { grabSystemPromptAppendOverview } from "@/src/functions/backend/db/app-settings/grab-system-prompt-append";
import runningVersion from "@/src/utils/running-version";
@@ -45,6 +46,7 @@ export default async function grabSettingsServerProps({ req }: Params) {
has_password,
storage_quota: await grabStorageQuotaOverview().catch(() => null),
system_prompt_append: await grabSystemPromptAppendOverview().catch(() => null),
run_limits: await grabRunLimitsOverview().catch(() => null),
running_version: runningVersion({ env: process.env }),
},
};
@@ -0,0 +1,134 @@
import { useState } from "react";
import fetchApi from "@moduletrace/twui/utils/fetch/fetchApi";
import type { APIResponseObject } from "@moduletrace/bunext/types";
import Form from "@moduletrace/twui/form/Form";
import Input from "@moduletrace/twui/form/Input";
import Stack from "@moduletrace/twui/layout/Stack";
import type { RunLimitsOverview } from "@/src/functions/backend/db/app-settings/grab-run-limits";
import SettingsSaveBar from "../../(partials)/settings-save-bar";
type Props = {
limits?: RunLimitsOverview | null;
};
/**
* How many model turns a task run and a chat reply may take, saved on its
* own without a reload. Zero puts the code's default back for that one.
*/
export default function RunLimitsForm({ limits }: Props) {
const [overview, setOverview] = useState(limits || undefined);
const [dirty, setDirty] = useState(false);
const [task_steps, setTaskSteps] = useState(String(limits?.task_steps ?? ""));
const [reply_steps, setReplySteps] = useState(String(limits?.reply_steps ?? ""));
/**
* The inputs only read `defaultValue` when they mount, so discarding or
* saving remounts them with the saved numbers.
*/
const [form_key, setFormKey] = useState(0);
const [loading, setLoading] = useState(false);
const [status, setStatus] = useState<{
msg?: string;
error?: boolean;
success?: boolean;
}>();
const save = async () => {
setLoading(true);
setStatus(undefined);
const res = await fetchApi<{}, APIResponseObject<RunLimitsOverview>>(
"/api/admin/settings/run-limits",
{
method: "POST",
body: {
task_steps: Number(task_steps) || 0,
reply_steps: Number(reply_steps) || 0,
},
},
).catch(() => null);
setLoading(false);
if (!res?.success || !res.singleRes) {
setStatus({
error: true,
msg: res?.msg || `Couldn't save the limits.`,
});
return;
}
setOverview(res.singleRes);
setTaskSteps(String(res.singleRes.task_steps));
setReplySteps(String(res.singleRes.reply_steps));
setFormKey((key) => key + 1);
setDirty(false);
setStatus({
success: true,
msg: `Saved: ${res.singleRes.task_steps} steps per task, ${res.singleRes.reply_steps} per reply.`,
});
};
const discard = () => {
setTaskSteps(String(overview?.task_steps ?? ""));
setReplySteps(String(overview?.reply_steps ?? ""));
setFormKey((key) => key + 1);
setDirty(false);
setStatus(undefined);
};
return (
<Form
onSubmit={(event) => {
event.preventDefault();
save().catch(() => {});
}}
className="w-full gap-3! items-stretch"
>
<Stack className="w-full gap-3! items-stretch">
<Input
key={`task-${form_key}`}
label="Tool steps per task"
type="number"
min={0}
max={overview?.max}
step={1}
numberText
rawNumber
defaultValue={task_steps}
onChange={(event) => {
setTaskSteps(event.target.value);
setDirty(true);
setStatus(undefined);
}}
suffix={`steps`}
info={`How many turns the model may take before it must stop and report, when it works on a task. 0 uses the default (${overview?.task_default ?? ""}).`}
/>
<Input
key={`reply-${form_key}`}
label="Tool steps per chat reply"
type="number"
min={0}
max={overview?.max}
step={1}
numberText
rawNumber
defaultValue={reply_steps}
onChange={(event) => {
setReplySteps(event.target.value);
setDirty(true);
setStatus(undefined);
}}
suffix={`steps`}
info={`How many turns a chat reply may take before it answers. Long work belongs in a task. 0 uses the default (${overview?.reply_default ?? ""}).`}
/>
</Stack>
<SettingsSaveBar
dirty={dirty}
loading={loading}
status={status}
save_label="Save limits"
onDiscard={discard}
/>
</Form>
);
}
@@ -0,0 +1,25 @@
import { useContext } from "react";
import { AppContext } from "@/src/pages/__root";
import isPassThroughUser from "@/src/utils/rbac/is-pass-through-user";
import SettingsGroup from "../../(partials)/settings-group";
import RunLimitsForm from "../(partials)/run-limits-form";
/**
* How long a bot may work on one task or reply before it reports. Only the
* super admin sees it, since it changes every bot on the install.
*/
export default function RunLimitsSection() {
const { pageProps } = useContext(AppContext);
if (!isPassThroughUser({ user_types: pageProps?.user_types })) return null;
return (
<SettingsGroup
title="Run limits"
description="How many turns a bot may take with its tools before it must stop and report. A task may take far more than a chat reply, since it does the long work."
id="run-limits"
>
<RunLimitsForm limits={pageProps?.run_limits} />
</SettingsGroup>
);
}
@@ -1,6 +1,7 @@
import AppearanceSection from "./(sections)/appearance-section";
import NotificationsSection from "./(sections)/notifications-section";
import PromptSection from "./(sections)/prompt-section";
import RunLimitsSection from "./(sections)/run-limits-section";
import StorageSection from "./(sections)/storage-section";
import VersionSection from "./(sections)/version-section";
import SettingsShell from "../(partials)/settings-shell";
@@ -15,6 +16,7 @@ export default function AdminSettingsGeneralPage() {
<AppearanceSection />
<NotificationsSection />
<PromptSection />
<RunLimitsSection />
<StorageSection />
<VersionSection />
</SettingsShell>