⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
import { t } from 'elysia';
import { pageQueryFields, pageResponse } from '#shared/pagination';
import { runContextTokens, agentExecutionState } from '../model';
export const scheduleParams = t.Object({
projectKey: t.String(),
scheduleId: t.Numeric({ description: 'Schedule id from list_agent_schedules.' }),
});
export const scheduleRunParams = t.Object({
projectKey: t.String(),
scheduleId: t.Numeric({ description: 'Schedule id from list_agent_schedules.' }),
runId: t.Numeric({ description: 'Run id from list_agent_schedule_runs.' }),
});
export const scheduleStatus = t.UnionEnum(['active', 'paused'], {
// t.UnionEnum defaults to its first value, which would resume a paused schedule on a
// PATCH that leaves the status out; the update is partial.
default: undefined,
description: "'active' runs, 'paused' does not run until it is set back to 'active'.",
});
export const scheduleType = t.String({
minLength: 1,
maxLength: 40,
description:
"'cron' runs the task on a cron. 'status' runs on an issue each time one enters a " +
'column: moved there, or created in it. An instance may add types of its own, which ' +
'take no cron and no column.',
});
export const scheduleOptions = t.Record(t.String(), t.Any(), {
description:
'Settings that extensions of this instance read, such as conditions on the issues ' +
'that start a run. {} on an instance with none, which refuses any other value.',
});
export const createScheduleBody = t.Object({
agentId: t.Number({ description: 'Internal agent id from list_ai_agents that runs the task.' }),
name: t.String({ minLength: 1, maxLength: 120, description: 'Display name of the schedule.' }),
type: t.Optional(scheduleType),
prompt: t.Optional(
t.String({
maxLength: 20_000,
description:
"Task sent to the agent on every run. Required for a 'cron' schedule. Optional for " +
'any other, whose run already names the issue and what happened to it.',
}),
),
cron: t.Optional(
t.String({
minLength: 1,
maxLength: 120,
description:
"Five-field cron expression in UTC, e.g. '0 9 * * 1' for Mondays at 09:00. " +
"Required for a 'cron' schedule, refused on any other.",
}),
),
columnId: t.Optional(
t.Number({
description:
"Column id from get_project whose incoming issues start a run. Required for a 'status' " +
'schedule, refused on any other.',
}),
),
delaySec: t.Optional(
t.Integer({
minimum: 0,
maximum: 86400,
description:
'Seconds a run on an issue waits before the agent may pick it up; 0 by default. On a ' +
"'status' schedule, an issue that leaves the column in that time ends the run. " +
"Refused on a 'cron' schedule.",
}),
),
options: t.Optional(scheduleOptions),
status: t.Optional(scheduleStatus),
});
export const updateScheduleBody = t.Partial(t.Omit(createScheduleBody, ['type']));
// A schedule DTO (AgentScheduleRow from the service).
export const AgentScheduleResponse = t.Object({
id: t.Number(),
agentId: t.Number(),
agentName: t.String(),
name: t.String(),
type: scheduleType,
prompt: t.String(),
cron: t.Nullable(t.String()),
timezone: t.Literal('UTC'),
columnId: t.Nullable(t.Number()),
delaySec: t.Number(),
options: scheduleOptions,
status: scheduleStatus,
nextRunAt: t.Nullable(t.String()),
lastRunAt: t.Nullable(t.String()),
lastRunStatus: t.Nullable(t.String()),
pendingRuns: t.Number({ description: 'Runs of this schedule that have not started yet.' }),
canTrigger: t.Boolean({
description:
"Whether you may run or stop this schedule; an 'owner'-scoped agent serves its owner only.",
}),
supported: t.Boolean({
description:
'False for a schedule whose type or options come from Cloud or Pro and are not on this ' +
'instance. It is kept as it is but starts no run and cannot be updated, only deleted.',
}),
createdAt: t.String(),
updatedAt: t.String(),
});
export const AgentSchedulePageResponse = pageResponse(AgentScheduleResponse);
export const agentSchedulePageQuery = t.Object(pageQueryFields);
// One run of a schedule (ScheduleRunRow from the service), with the agent's answer in
// `output` once the run has finished.
export const ScheduleRunResponse = t.Object({
id: t.Number(),
kind: t.String(),
status: t.String(),
executionState: agentExecutionState,
trigger: t.String(),
prompt: t.String(),
attempts: t.Number(),
lastError: t.Nullable(t.String()),
output: t.Nullable(t.String()),
contextTokens: runContextTokens,
scheduledFor: t.Nullable(t.String()),
startedAt: t.Nullable(t.String()),
finishedAt: t.Nullable(t.String()),
createdAt: t.String(),
});
export const ScheduleRunListResponse = t.Array(ScheduleRunResponse);
export const QueuedRunResponse = t.Object({ runId: t.Number() });
export const CanceledRunsResponse = t.Object({
canceled: t.Number({ description: 'How many pending runs were ended.' }),
});