import type { ProviderApprovalDecision } from "@t3tools/contracts";
import * as Schema from "effect/Schema";
const NonEmptyString = Schema.String.check(Schema.isMinLength(1));
const MuseUsage = Schema.Struct({
inputTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
outputTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
cachedTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
reasoningTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
cacheReadTokens: Schema.optional(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))),
cacheWriteTokens: Schema.optional(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))),
});
export const MuseItem = Schema.Struct({
entryId: Schema.optional(Schema.String),
children: Schema.optional(
Schema.Array(
Schema.Struct({
childId: NonEmptyString,
attempt: Schema.Int,
status: Schema.String,
label: Schema.optional(Schema.String),
terminal: Schema.optional(Schema.String),
durationMs: Schema.optional(Schema.Finite),
/** Present on a failed attempt, even one whose `terminal` is `completed`. */
failureKind: Schema.optional(Schema.String),
failureReason: Schema.optional(Schema.String),
}),
),
),
finalSummary: Schema.optional(Schema.String),
itemId: NonEmptyString,
kind: NonEmptyString,
revision: Schema.Int.check(Schema.isGreaterThan(0)),
status: NonEmptyString,
turnId: Schema.optional(Schema.NullOr(Schema.String)),
text: Schema.optional(Schema.String),
summary: Schema.optional(Schema.Array(Schema.String)),
tool: Schema.optional(Schema.String),
args: Schema.optional(Schema.String),
visibleOutput: Schema.optional(Schema.String),
truncated: Schema.optional(Schema.Boolean),
failureReason: Schema.optional(Schema.String),
fallbackText: Schema.optional(Schema.String),
commandText: Schema.optional(Schema.String),
exitCode: Schema.optional(Schema.Int),
durationMs: Schema.optional(Schema.Finite),
subagentId: Schema.optional(Schema.String),
childSessionId: Schema.optional(Schema.String),
objective: Schema.optional(Schema.String),
role: Schema.optional(Schema.String),
controlStatus: Schema.optional(Schema.String),
result: Schema.optional(
Schema.Struct({ summary: Schema.String, text: Schema.optional(Schema.String) }),
),
usage: Schema.optional(MuseUsage),
outcome: Schema.optional(Schema.String),
trigger: Schema.optional(Schema.String),
reason: Schema.optional(Schema.String),
});
export type MuseItem = typeof MuseItem.Type;
export const MuseSessionResult = Schema.Struct({
session: Schema.Struct({
sessionId: NonEmptyString,
modelId: Schema.optional(Schema.NullOr(Schema.String)),
activeTurnId: Schema.optional(Schema.NullOr(Schema.String)),
}),
history: Schema.optional(
Schema.Struct({
items: Schema.NullOr(Schema.Array(MuseItem)),
noneReason: Schema.optional(Schema.String),
snapshot: Schema.optional(
Schema.NullOr(
Schema.Struct({
schemaVersion: Schema.optional(Schema.Int),
state: Schema.Struct({ items: Schema.Array(MuseItem) }),
}),
),
),
}),
),
});
export const MuseTurnStartResult = Schema.Struct({ turnId: NonEmptyString });
export const MuseApproval = Schema.Struct({
approvalId: NonEmptyString,
protectedWrite: Schema.optional(Schema.Boolean),
judgeEscalated: Schema.optional(Schema.Boolean),
sessionId: NonEmptyString,
turnId: Schema.optional(Schema.String),
itemId: Schema.optional(Schema.String),
toolName: Schema.optional(Schema.String),
rawArgs: Schema.optional(Schema.String),
/** Set when a workflow child asks; `turnId` is then the child's run, not a session turn. */
subagentOrigin: Schema.optional(Schema.Struct({ subagentId: NonEmptyString })),
currentRequirementId: Schema.Struct({ approvalId: NonEmptyString, sourceIndex: Schema.Int }),
availableChoices: Schema.Array(
Schema.Struct({
choiceId: NonEmptyString,
label: Schema.String,
decision: NonEmptyString,
scope: Schema.String,
}),
),
subject: Schema.Struct({
kind: Schema.String,
access: Schema.optional(Schema.String),
command: Schema.optional(Schema.String),
path: Schema.optional(Schema.String),
host: Schema.optional(Schema.String),
target: Schema.optional(Schema.String),
}),
});
export type MuseApproval = typeof MuseApproval.Type;
export const MuseUserInput = Schema.Struct({
userInputId: NonEmptyString,
sessionId: NonEmptyString,
turnId: NonEmptyString,
questions: Schema.Array(
Schema.Struct({
id: NonEmptyString,
header: Schema.String,
question: Schema.String,
options: Schema.Array(
Schema.Struct({ label: Schema.String, description: Schema.optional(Schema.String) }),
),
selection: Schema.Struct({
mode: Schema.Literals(["single", "multiple"]),
minSelections: Schema.optional(Schema.Int),
maxSelections: Schema.optional(Schema.Int),
}),
}),
),
});
export type MuseUserInput = typeof MuseUserInput.Type;
export const MuseTokenUsageEvent = Schema.Struct({
turnId: NonEmptyString,
promptTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
usage: MuseUsage,
});
export const MuseContextUsage = Schema.Struct({
usedTokens: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
windowTokens: Schema.optional(Schema.Int.check(Schema.isGreaterThan(0))),
});
export const MuseTodoList = Schema.Struct({
items: Schema.Array(Schema.Struct({ text: Schema.String, status: Schema.String })),
});
export const MuseTurnCompleted = Schema.Struct({
turnId: NonEmptyString,
terminal: NonEmptyString,
reason: Schema.optional(Schema.String),
error: Schema.optional(
Schema.Struct({
message: Schema.String,
quota: Schema.optional(Schema.Struct({ resetsAtMs: Schema.Finite })),
}),
),
usage: Schema.optional(MuseUsage),
});
/** The latest instant a JavaScript Date holds; formatting a later one throws. */
export const LATEST_DATE_MS = 8.64e15;
const DateMillis = Schema.Finite.check(
Schema.isGreaterThan(0),
Schema.isLessThanOrEqualTo(LATEST_DATE_MS),
);
/** Latest response subscription windows; verbatim Meta percentages may exceed 100. */
export const MuseSubscriptionUsage = Schema.Struct({
observedAtMs: DateMillis,
tier: Schema.String,
window: Schema.Struct({
usedPercent: Schema.Finite.check(Schema.isGreaterThanOrEqualTo(0)),
windowDurationMins: Schema.Finite.check(Schema.isGreaterThan(0)),
resetsAtMs: DateMillis,
}),
weekly: Schema.Struct({
usedPercent: Schema.Finite.check(Schema.isGreaterThanOrEqualTo(0)),
resetsAtMs: DateMillis,
}),
});
export type MuseSubscriptionUsage = typeof MuseSubscriptionUsage.Type;
export const MuseTurnRetryScheduled = Schema.Struct({
turnId: NonEmptyString,
nextAttempt: Schema.Int.check(Schema.isGreaterThan(0)),
maxAttempts: Schema.Int.check(Schema.isGreaterThan(0)),
reason: NonEmptyString,
retryDelayMs: Schema.Finite.check(Schema.isGreaterThanOrEqualTo(0)),
});
export const MuseCompactResult = Schema.Struct({
status: Schema.String,
reason: Schema.optional(Schema.String),
});
export const MuseItemEvent = Schema.Struct({ item: MuseItem });
export const MuseDelta = Schema.Struct({
itemId: NonEmptyString,
delta: Schema.String,
field: Schema.optional(Schema.String),
});
export function museApprovalDecision(
choice: Pick<MuseApproval["availableChoices"][number], "decision" | "scope">,
): ProviderApprovalDecision | undefined {
switch (choice.decision) {
case "approved":
return "accept";
case "approvedForSession":
return "acceptForSession";
case "approvedPolicyAmendment":
return choice.scope === "session"
? "acceptForSession"
: choice.scope === "localPersistent"
? "acceptAlways"
: undefined;
case "denied":
case "deniedPolicyAmendment":
return "decline";
case "abort":
return "cancel";
default:
return undefined;
}
}
/** Shell approvals offer abort instead of denied; decline falls back to abort. */
export function museApprovalChoices(approval: Pick<MuseApproval, "availableChoices">) {
const choices = new Map<ProviderApprovalDecision, MuseApproval["availableChoices"][number]>();
const rank = (choice: MuseApproval["availableChoices"][number]) =>
(choice.scope === "once" ? 0 : choice.scope === "session" ? 2 : 4) +
(choice.decision.endsWith("PolicyAmendment") ? 1 : 0);
for (const choice of approval.availableChoices) {
const decision = museApprovalDecision(choice);
if (!decision) continue;
const previous = choices.get(decision);
if (!previous || rank(choice) < rank(previous)) choices.set(decision, choice);
}
const abort = choices.get("cancel");
if (!choices.has("decline") && abort) choices.set("decline", abort);
return choices;
}
export function museApprovalOptions(approval: Pick<MuseApproval, "availableChoices">) {
const choices = museApprovalChoices(approval);
const declineChoiceId = choices.get("decline")?.choiceId;
return [...choices]
.filter(([decision, choice]) => decision !== "cancel" || choice.choiceId !== declineChoiceId)
.map(([decision, choice]) => ({ decision, label: choice.label }));
}