import {z} from 'zod' export type ApprovalPolicy = {approvers?: Array | undefined, approvers_by_tool?: {[key: string]: Array} | undefined, escalation_rules?: Array | undefined, requires_human_approval?: (boolean | null) | undefined}; export type ScopedSpendCapInput = {amount_usd: number | string, category?: ('llm' | 'tools' | null) | undefined, client_id?: (string | null) | undefined, connection_id?: (string | null) | undefined, currency?: (string | null) | undefined, own_agent?: boolean | undefined, period?: ('run' | null) | undefined, tool?: (string | null) | undefined}; export type BudgetPolicyInput = {agent_monthly_spend_cap_usd?: (number | string | null) | undefined, monthly_spend_cap_usd?: (number | string | null) | undefined, run_budget_usd?: (number | string | null) | undefined, service_budget_usd?: (number | string | null) | undefined, spend_caps?: (Array | null) | undefined}; export type AnswerCheckPolicy = {enabled?: boolean | undefined, language?: (string | null) | undefined, rewrite_instruction?: (string | null) | undefined}; export type ContentSafetyPolicy = {answer_check?: (AnswerCheckPolicy | null) | undefined, prompt_injection_detection_enabled?: (boolean | null) | undefined}; export type ExecutionLimitsPolicy = {max_model_turns?: (number | null) | undefined, max_tool_calls_per_turn?: (number | null) | undefined, max_tool_calls_total?: (number | null) | undefined}; export type TokenPolicy = {max_tokens?: (number | null) | undefined, max_tokens_per_call?: (number | null) | undefined}; export type ToolsPolicy = {allowed?: (Array | null) | undefined, denied?: Array | undefined}; export type PolicyDocument = {approval?: (ApprovalPolicy | null) | undefined, budget?: (BudgetPolicyInput | null) | undefined, content_safety?: (ContentSafetyPolicy | null) | undefined, execution?: (ExecutionLimitsPolicy | null) | undefined, tokens?: (TokenPolicy | null) | undefined, tools?: (ToolsPolicy | null) | undefined}; export type EffectivePolicyPreviewRequest = {agent_id?: (string | null) | undefined, task_policy?: (PolicyDocument | null) | undefined}; export type CreateApiV1WorkspacesWorkspaceGovernanceEffectivePolicyPreviewArgs = {workspace: string, body: EffectivePolicyPreviewRequest}; export type CreateApiV1WorkspacesWorkspaceGovernanceEffectivePolicyPreviewOptions = {baseUrl: string, HTTPBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const approvalPolicy = z.object({approvers: z.array(z.string()).optional(), approvers_by_tool: z.record(z.string(), z.array(z.string())).optional(), escalation_rules: z.array(z.string()).optional(), requires_human_approval: z.boolean().nullable().optional()}); export const scopedSpendCapOutput = z.object({amount_usd: z.string(), category: z.enum(["llm", "tools"]).nullable().optional(), client_id: z.string().nullable().optional(), connection_id: z.string().nullable().optional(), currency: z.string().nullable().optional(), own_agent: z.boolean().optional(), period: z.literal("run").nullable().optional(), tool: z.string().nullable().optional()}); export const budgetPolicyOutput = z.object({agent_monthly_spend_cap_usd: z.string().nullable().optional(), monthly_spend_cap_usd: z.string().nullable().optional(), run_budget_usd: z.string().nullable().optional(), service_budget_usd: z.string().nullable().optional(), spend_caps: z.array(scopedSpendCapOutput).nullable().optional()}); export const answerCheckPolicy = z.object({enabled: z.boolean().optional(), language: z.string().min(2).max(8).nullable().optional(), rewrite_instruction: z.string().min(1).max(4000).nullable().optional()}); export const contentSafetyPolicy = z.object({answer_check: answerCheckPolicy.nullable().optional(), prompt_injection_detection_enabled: z.boolean().nullable().optional()}); export const executionLimitsPolicy = z.object({max_model_turns: z.number().int().gt(0).nullable().optional(), max_tool_calls_per_turn: z.number().int().gt(0).nullable().optional(), max_tool_calls_total: z.number().int().gt(0).nullable().optional()}); export const tokenPolicy = z.object({max_tokens: z.number().int().gt(0).nullable().optional(), max_tokens_per_call: z.number().int().gt(0).nullable().optional()}); export const toolsPolicy = z.object({allowed: z.array(z.string()).nullable().optional(), denied: z.array(z.string()).optional()}); export const effectivePolicy = z.object({approval: approvalPolicy.nullable().optional(), budget: budgetPolicyOutput.nullable().optional(), content_safety: contentSafetyPolicy.nullable().optional(), execution: executionLimitsPolicy.nullable().optional(), resolver_version: z.string().optional(), source_policy_ids: z.array(z.string()).optional(), tokens: tokenPolicy.nullable().optional(), tools: toolsPolicy.nullable().optional()}); export const effectivePolicyResponse = z.object({effective_policy: effectivePolicy}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Preview Effective Policy * * POST /v1/workspaces/{workspace}/governance/effective-policy/preview */ export const createApiV1WorkspacesWorkspaceGovernanceEffectivePolicyPreview = async (args: CreateApiV1WorkspacesWorkspaceGovernanceEffectivePolicyPreviewArgs, options: CreateApiV1WorkspacesWorkspaceGovernanceEffectivePolicyPreviewOptions) => { const {baseUrl, fetch: fetchFn = fetch, HTTPBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (HTTPBearer !== undefined) headers.set('authorization', `Bearer ${HTTPBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/workspaces/${encodeURIComponent(String(args.workspace))}/governance/effective-policy/preview${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(effectivePolicyResponse, await res.json()) };