Skip to content
← Public packages

@kentcdodds/codebase-cleanup

Cursor cloud agents for legacy cleanup, docs freshness, tight tests, and prod CI fixes, plus a weekly Devin general audit.

FollowFork

Files

devin.ts

76 lines · 2.2 KB · TypeScript
import { devinRequest, resolveOrgId } from 'kody:@kentcdodds/devin/request'
import { SELF_KODY_ID, type AutomationId, type DevinMode } from './shared.ts'

/** Devin v3 create-session path; `{org_id}` is filled in by @kentcdodds/devin/request. */
export const devinCreateSessionPath = '/v3/organizations/{org_id}/sessions'

export type DevinSessionRequest = {
	method: 'POST'
	path: typeof devinCreateSessionPath
	body: {
		prompt: string
		title: string
		tags: string[]
		repos: string[]
		devin_mode: DevinMode
		max_acu_limit?: number
	}
}

/**
 * Build the exact Devin create-session request a Devin automation sends.
 * dryRun returns this object; a live run sends it unchanged.
 */
export function buildDevinSessionRequest(input: {
	automation: AutomationId
	repo: string
	prompt: string
	devinMode: DevinMode
	maxAcuLimit: number | null
}): DevinSessionRequest {
	const body: DevinSessionRequest['body'] = {
		prompt: input.prompt,
		title: `${input.automation} ${input.repo}`.slice(0, 80),
		tags: [SELF_KODY_ID, input.automation],
		repos: [input.repo],
		devin_mode: input.devinMode,
	}
	if (typeof input.maxAcuLimit === 'number' && input.maxAcuLimit > 0) {
		body.max_acu_limit = input.maxAcuLimit
	}
	return { method: 'POST', path: devinCreateSessionPath, body }
}

/** True when @kentcdodds/devin has an org id saved (never returns the id). */
export async function devinOrgConfigured() {
	try {
		return Boolean(await resolveOrgId())
	} catch {
		return false
	}
}

/** Send a create-session request. Consumes ACUs. */
export async function launchDevinSession(request: DevinSessionRequest) {
	const result = await devinRequest({
		path: request.path,
		method: request.method,
		body: request.body,
	})
	const body = (result.body ?? {}) as {
		session_id?: string
		url?: string
		devin_mode?: string | null
		detail?: unknown
		title?: unknown
	}
	if (result.status < 200 || result.status >= 300) {
		const detail = typeof body.detail === 'string' ? body.detail : typeof body.title === 'string' ? body.title : ''
		throw new Error(`Devin create session failed (${result.status})${detail ? `: ${detail}` : ''}`)
	}
	return {
		sessionId: body.session_id ?? null,
		url: body.url ?? null,
		devinMode: body.devin_mode ?? null,
	}
}