birdclaw 0.8.3 → 0.8.5

package/src/lib/actions-transport.ts

@@ -1,300 +0,0 @@
-import {
-	blockUserViaBird,
-	muteUserViaBird,
-	readBirdStatusViaBird,
-	unblockUserViaBird,
-	unmuteUserViaBird,
-} from "./bird-actions";
-import { type ActionsTransport, resolveActionsTransport } from "./config";
-import { Effect } from "effect";
-import { runEffectPromise, tryPromise } from "./effect-runtime";
-import type {
-	ModerationAction,
-	ModerationActionTransportResult,
-	ModerationTransportKind,
-} from "./types";
-import {
-	blockUserViaXurl,
-	lookupAuthenticatedUserFresh,
-	muteUserViaXurl,
-	unblockUserViaXurl,
-	unmuteUserViaXurl,
-} from "./xurl";
-
-export type ActionTransportResult = ModerationActionTransportResult;
-
-interface RunActionParams {
-	action: ModerationAction;
-	query: string;
-	targetUserId?: string;
-	transport?: string;
-	expectedAccount?: ExpectedActionAccount;
-}
-
-export interface ExpectedActionAccount {
-	id: string;
-	handle: string;
-	externalUserId?: string | null;
-}
-
-function toError(error: unknown) {
-	return error instanceof Error ? error : new Error(String(error));
-}
-
-function trySync<T>(try_: () => T) {
-	return Effect.try({
-		try: try_,
-		catch: toError,
-	});
-}
-
-function normalizeFailure(transport: ModerationTransportKind, output: string) {
-	return `${transport}: ${output}`;
-}
-
-function liveWritesDisabled() {
-	return process.env.BIRDCLAW_DISABLE_LIVE_WRITES === "1";
-}
-
-function normalizeHandle(value: string | null | undefined) {
-	return value?.replace(/^@/, "").toLowerCase() ?? "";
-}
-
-function verifyExpectedAccountEffect(
-	expectedAccount: ExpectedActionAccount | undefined,
-) {
-	return Effect.gen(function* () {
-		if (!expectedAccount) return null;
-		if (liveWritesDisabled()) return null;
-
-		const sourceUser = yield* tryPromise(() => lookupAuthenticatedUserFresh());
-		const sourceUserId =
-			sourceUser && typeof sourceUser.id === "string" ? sourceUser.id : "";
-		const sourceUsername =
-			sourceUser && typeof sourceUser.username === "string"
-				? normalizeHandle(sourceUser.username)
-				: "";
-		const expectedExternalUserId = expectedAccount.externalUserId?.trim() ?? "";
-		const expectedHandle = normalizeHandle(expectedAccount.handle);
-
-		if (expectedExternalUserId) {
-			if (sourceUserId === expectedExternalUserId) return sourceUserId;
-			return yield* Effect.fail(
-				new Error(
-					`xurl is authenticated as user ${sourceUserId || "unknown"}, not account ${expectedAccount.id}`,
-				),
-			);
-		}
-
-		if (expectedHandle && sourceUsername === expectedHandle)
-			return sourceUserId;
-		return yield* Effect.fail(
-			new Error(
-				sourceUsername
-					? `xurl is authenticated as @${sourceUsername}, not @${expectedHandle}`
-					: "xurl authenticated user unavailable",
-			),
-		);
-	});
-}
-
-function runBirdActionEffect(
-	action: ModerationAction,
-	query: string,
-): Effect.Effect<ActionTransportResult, unknown> {
-	return Effect.gen(function* () {
-		const result = yield* tryPromise(() =>
-			action === "block"
-				? blockUserViaBird(query)
-				: action === "unblock"
-					? unblockUserViaBird(query)
-					: action === "mute"
-						? muteUserViaBird(query)
-						: unmuteUserViaBird(query),
-		);
-
-		return {
-			...result,
-			transport: "bird",
-		};
-	});
-}
-
-function getVerifyExpectation(action: ModerationAction) {
-	return action === "block" || action === "unblock"
-		? {
-				field: "blocking" as const,
-				expected: action === "block",
-			}
-		: {
-				field: "muting" as const,
-				expected: action === "mute",
-			};
-}
-
-function runXurlActionEffect(
-	action: ModerationAction,
-	query: string,
-	targetUserId?: string,
-	verifiedSourceUserId?: string | null,
-): Effect.Effect<ActionTransportResult, unknown> {
-	return Effect.gen(function* () {
-		if (!targetUserId) {
-			return {
-				ok: false,
-				output: "missing target user id for xurl transport",
-				transport: "xurl",
-			};
-		}
-
-		let sourceUserId = verifiedSourceUserId ?? "";
-		if (!sourceUserId) {
-			const sourceUser = yield* tryPromise(() =>
-				lookupAuthenticatedUserFresh(),
-			);
-			sourceUserId =
-				sourceUser && typeof sourceUser.id === "string" ? sourceUser.id : "";
-		}
-		if (!sourceUserId) {
-			return {
-				ok: false,
-				output: "xurl authenticated user unavailable",
-				transport: "xurl",
-			};
-		}
-
-		const result = yield* tryPromise(() =>
-			action === "block"
-				? blockUserViaXurl(sourceUserId, targetUserId)
-				: action === "unblock"
-					? unblockUserViaXurl(sourceUserId, targetUserId)
-					: action === "mute"
-						? muteUserViaXurl(sourceUserId, targetUserId)
-						: unmuteUserViaXurl(sourceUserId, targetUserId),
-		);
-
-		if (!result.ok) {
-			return {
-				...result,
-				transport: "xurl",
-			};
-		}
-
-		const status = yield* tryPromise(() => readBirdStatusViaBird(query));
-		const { field: verifyField, expected: expectedValue } =
-			getVerifyExpectation(action);
-		const actualValue =
-			status && typeof status[verifyField] === "boolean"
-				? Boolean(status[verifyField])
-				: null;
-
-		if (actualValue === null) {
-			return {
-				ok: false,
-				output: `${result.output}\nxurl verify unavailable from bird status`,
-				transport: "xurl",
-			};
-		}
-
-		if (actualValue !== expectedValue) {
-			return {
-				ok: false,
-				output: `${result.output}\nxurl verify mismatch ${verifyField}=${String(actualValue)}`,
-				transport: "xurl",
-			};
-		}
-
-		return {
-			ok: true,
-			output: `${result.output}\nverified ${verifyField}=${String(actualValue)}`,
-			transport: "xurl",
-		};
-	});
-}
-
-export function runModerationActionEffect({
-	action,
-	query,
-	targetUserId,
-	transport,
-	expectedAccount,
-}: RunActionParams): Effect.Effect<ActionTransportResult, unknown> {
-	return Effect.gen(function* () {
-		const requestedTransport = yield* trySync(() =>
-			resolveActionsTransport(transport),
-		);
-
-		const verifyXurlAccount = () =>
-			verifyExpectedAccountEffect(expectedAccount).pipe(
-				Effect.catchAll((error) =>
-					Effect.succeed({
-						ok: false as const,
-						output: error instanceof Error ? error.message : String(error),
-						transport: "xurl" as const,
-					}),
-				),
-			);
-
-		if (requestedTransport === "bird") {
-			return yield* runBirdActionEffect(action, query);
-		}
-		if (requestedTransport === "xurl") {
-			const accountCheck = yield* verifyXurlAccount();
-			if (accountCheck && typeof accountCheck === "object") {
-				return accountCheck;
-			}
-			return yield* runXurlActionEffect(
-				action,
-				query,
-				targetUserId,
-				typeof accountCheck === "string" ? accountCheck : null,
-			);
-		}
-
-		const birdResult = yield* runBirdActionEffect(action, query);
-		if (birdResult.ok) {
-			return birdResult;
-		}
-
-		const accountCheck = yield* verifyXurlAccount();
-		if (accountCheck && typeof accountCheck === "object") {
-			return {
-				ok: false,
-				output: [
-					normalizeFailure("bird", birdResult.output),
-					normalizeFailure("xurl", accountCheck.output),
-				].join("\n"),
-				transport: "xurl",
-			};
-		}
-		const xurlResult = yield* runXurlActionEffect(
-			action,
-			query,
-			targetUserId,
-			typeof accountCheck === "string" ? accountCheck : null,
-		);
-		if (xurlResult.ok) {
-			return {
-				...xurlResult,
-				output: `${xurlResult.output}\nfalling back after ${normalizeFailure("bird", birdResult.output)}`,
-			};
-		}
-
-		return {
-			ok: false,
-			output: [
-				normalizeFailure("bird", birdResult.output),
-				normalizeFailure("xurl", xurlResult.output),
-			].join("\n"),
-			transport: xurlResult.transport,
-		};
-	});
-}
-
-export function runModerationAction(
-	params: RunActionParams,
-): Promise<ActionTransportResult> {
-	return runEffectPromise(runModerationActionEffect(params));
-}
-
-export type { ActionsTransport };

package/src/lib/analysis-runtime.ts

@@ -1,238 +0,0 @@
-import { Effect } from "effect";
-import { tryPromise } from "./effect-runtime";
-import {
-	readOpenAIResponseStreamEffect,
-	requestOpenAIResponseEffect,
-} from "./openai-response-runtime";
-import {
-	defaultRuntimeServices,
-	type RuntimeServices,
-} from "./runtime-services";
-
-const DEFAULT_MODEL = "gpt-5.5";
-const DEFAULT_REASONING_EFFORT = "medium";
-const DEFAULT_SERVICE_TIER = "priority";
-const DEFAULT_DELIMITER_PATTERN = /\n---\s*\n/;
-
-export type AnalysisReasoningEffort = "minimal" | "low" | "medium" | "high";
-export type AnalysisServiceTier = "default" | "flex" | "priority";
-
-export interface AnalysisModelOptions {
-	model?: string;
-	reasoningEffort?: AnalysisReasoningEffort;
-	serviceTier?: AnalysisServiceTier;
-}
-
-export interface AnalysisModelSettings {
-	model: string;
-	reasoningEffort: AnalysisReasoningEffort;
-	serviceTier: AnalysisServiceTier;
-}
-
-export interface HybridAnalysisResult<T> {
-	value: T;
-	markdown: string;
-	rawText: string;
-	responseId?: string;
-	usage?: unknown;
-}
-
-function toError(error: unknown) {
-	return error instanceof Error ? error : new Error(String(error));
-}
-
-export function resolveAnalysisModelSettings(
-	options: AnalysisModelOptions,
-	runtime: RuntimeServices = defaultRuntimeServices,
-): AnalysisModelSettings {
-	return {
-		model: options.model ?? runtime.env("BIRDCLAW_AI_MODEL") ?? DEFAULT_MODEL,
-		reasoningEffort:
-			options.reasoningEffort ??
-			(runtime.env(
-				"BIRDCLAW_OPENAI_REASONING_EFFORT",
-			) as AnalysisReasoningEffort) ??
-			DEFAULT_REASONING_EFFORT,
-		serviceTier:
-			options.serviceTier ??
-			(runtime.env("BIRDCLAW_OPENAI_SERVICE_TIER") as AnalysisServiceTier) ??
-			DEFAULT_SERVICE_TIER,
-	};
-}
-
-export function createAnalysisRequestBody({
-	settings,
-	system,
-	prompt,
-	stream,
-	maxOutputTokens = 7000,
-}: {
-	settings: AnalysisModelSettings;
-	system: string;
-	prompt: string;
-	stream: boolean;
-	maxOutputTokens?: number;
-}) {
-	return {
-		model: settings.model,
-		reasoning: { effort: settings.reasoningEffort },
-		service_tier: settings.serviceTier,
-		store: false,
-		...(stream ? { stream: true } : {}),
-		max_output_tokens: maxOutputTokens,
-		input: [
-			{ role: "system", content: system },
-			{ role: "user", content: prompt },
-		],
-	};
-}
-
-export function parseHybridAnalysis<T>({
-	rawText,
-	parse,
-	fallback,
-	delimiterPattern = DEFAULT_DELIMITER_PATTERN,
-}: {
-	rawText: string;
-	parse: (value: unknown) => T;
-	fallback: (markdown: string) => T;
-	delimiterPattern?: RegExp;
-}) {
-	const [markdownPart, jsonPart] = rawText.split(delimiterPattern);
-	const markdown = (markdownPart ?? rawText).trim();
-	const candidate = jsonPart?.slice(
-		jsonPart.indexOf("{"),
-		jsonPart.lastIndexOf("}") + 1,
-	);
-	if (candidate?.startsWith("{")) {
-		try {
-			return { markdown, value: parse(JSON.parse(candidate)) };
-		} catch {
-			return { markdown, value: fallback(markdown) };
-		}
-	}
-	return { markdown, value: fallback(markdown) };
-}
-
-export function extractOpenAIResponseText(payload: Record<string, unknown>) {
-	if (typeof payload.output_text === "string") {
-		return payload.output_text;
-	}
-	const output = Array.isArray(payload.output) ? payload.output : [];
-	const parts: string[] = [];
-	for (const item of output) {
-		if (!item || typeof item !== "object") continue;
-		const content = (item as { content?: unknown }).content;
-		if (!Array.isArray(content)) continue;
-		for (const block of content) {
-			if (!block || typeof block !== "object") continue;
-			const record = block as Record<string, unknown>;
-			if (typeof record.text === "string") parts.push(record.text);
-		}
-	}
-	return parts.join("");
-}
-
-export function readHybridAnalysisStreamEffect<T>(
-	response: Response,
-	{
-		parse,
-		fallback,
-		onDelta,
-		delimiterPattern = DEFAULT_DELIMITER_PATTERN,
-	}: {
-		parse: (value: unknown) => T;
-		fallback: (markdown: string) => T;
-		onDelta?: (delta: string) => void;
-		delimiterPattern?: RegExp;
-	},
-): Effect.Effect<HybridAnalysisResult<T>, Error> {
-	return Effect.gen(function* () {
-		const stream = yield* readOpenAIResponseStreamEffect(response, {
-			delimiterPattern,
-			onDelta,
-		});
-		const parsed = parseHybridAnalysis({
-			rawText: stream.rawText,
-			parse,
-			fallback,
-			delimiterPattern,
-		});
-		return {
-			...parsed,
-			rawText: stream.rawText,
-			...(stream.responseId ? { responseId: stream.responseId } : {}),
-			...(stream.usage === undefined ? {} : { usage: stream.usage }),
-		};
-	});
-}
-
-export function streamHybridAnalysisEffect<T>({
-	body,
-	signal,
-	runtime = defaultRuntimeServices,
-	parse,
-	fallback,
-	onDelta,
-	delimiterPattern = DEFAULT_DELIMITER_PATTERN,
-}: {
-	body: unknown;
-	signal?: AbortSignal;
-	runtime?: RuntimeServices;
-	parse: (value: unknown) => T;
-	fallback: (markdown: string) => T;
-	onDelta?: (delta: string) => void;
-	delimiterPattern?: RegExp;
-}): Effect.Effect<HybridAnalysisResult<T>, Error> {
-	return Effect.gen(function* () {
-		const response = yield* requestOpenAIResponseEffect({
-			body,
-			signal,
-			runtime,
-		});
-		return yield* readHybridAnalysisStreamEffect(response, {
-			parse,
-			fallback,
-			onDelta,
-			delimiterPattern,
-		});
-	});
-}
-
-export function requestHybridAnalysisEffect<T>({
-	body,
-	signal,
-	runtime = defaultRuntimeServices,
-	parse,
-	fallback,
-	delimiterPattern = DEFAULT_DELIMITER_PATTERN,
-}: {
-	body: unknown;
-	signal?: AbortSignal;
-	runtime?: RuntimeServices;
-	parse: (value: unknown) => T;
-	fallback: (markdown: string) => T;
-	delimiterPattern?: RegExp;
-}): Effect.Effect<HybridAnalysisResult<T>, Error> {
-	return Effect.gen(function* () {
-		const response = yield* requestOpenAIResponseEffect({
-			body,
-			signal,
-			runtime,
-		});
-		const payload = (yield* tryPromise(() => response.json()).pipe(
-			Effect.mapError(toError),
-		)) as Record<string, unknown>;
-		const rawText = extractOpenAIResponseText(payload);
-		if (!rawText) {
-			return yield* Effect.fail(new Error("OpenAI returned no output text"));
-		}
-		const parsed = parseHybridAnalysis({
-			rawText,
-			parse,
-			fallback,
-			delimiterPattern,
-		});
-		return { ...parsed, rawText };
-	});
-}