ローカル関数

[functions]
enabled = true
dir = "./functions"              # 相対パスはこの設定ファイルからの相対
# default_timeout = "5m"         # 呼び出しごとの期限。関数側で上書き可能
# hot_reload = false             # ディレクトリを監視し、保存時にリロード
# allow_unauthenticated = false  # 下記「セキュリティ」を参照
# cors_allowed_origins = ["http://localhost:3000"]

[functions.config]               # 任意。context.config として関数に渡る
# api_base = "https://example.internal"

export const meta: ButtressFunctionMeta = {
  description: 'Transcribe the audio track of a video file',
  parameters: {
    type: 'object',
    properties: {
      path: { type: 'string', description: 'Path to a video on the server' },
    },
    required: ['path'],
  },
  timeout: '10m',
}

export default async function ({ path }: { path: string }, context: ButtressFunctionContext) {
  const wav = `${context.tempDir}/audio.wav`
  const { code, stderr } = await context.spawn('ffmpeg', ['-i', path, '-ar', '16000', wav])
  if (code !== 0) throw new Error(`ffmpeg failed: ${stderr}`)

  context.emit('progress', { stage: 'transcribing' })
  return context.buttress.transcribe({ filePath: wav })
}

import fs from 'node:fs/promises'     // 組み込み — 可
import { helper } from './lib/util'   // 同階層ファイル — 可
import sqlite3 from 'sqlite3'         // 許可リストのパッケージ — 可
import axios from 'axios'             // それ以外のパッケージ — 不可

[[generators]]
type = "ggml-llm"

[generators.model]
repo_id = "nomic-ai/nomic-embed-text-v1.5-GGUF"
filename = "nomic-embed-text-v1.5.Q8_0.gguf"
embedding = true
pooling_type = "mean"
n_ctx = 2048

curl -X POST http://localhost:2080/functions/host-info \
  -H 'Authorization: Bearer <workspace-access-token>' \
  -H 'Content-Type: application/json' \
  -d '{}'

curl 'http://localhost:2080/functions/weather?city=Taipei&days=3&units=metric'

curl 'http://localhost:2080/functions/weather?input={"days":3}&city=Taipei'

const { path } = await context.buttress.synthesize({ text: 'Hello from Buttress' })
return { audio: context.fileUrl(path) }

curl -X POST http://localhost:2080/functions/transcribe-media -F file=@interview.mp4

curl -F file=@interview.mp4 http://localhost:2080/functions/upload
# → { "path": "…", "url": "…", "name": "interview.mp4", "size": 20972112 }

bricks buttress mcp-config --write

{
  "mcpServers": {
    "buttress-functions": {
      "url": "http://192.168.1.24:2080/functions/mcp",
      "headers": { "Authorization": "Bearer <workspace-access-token>" }
    }
  }
}

bricks buttress mcp-config --url http://buttress.local:2080 --no-token

[functions]
allow_unauthenticated = true

export const meta: ButtressAuthMeta = { mode: 'override' }

export default async function (request: ButtressAuthRequest, context: ButtressAuthContext) {
  if (request.workspaceAuth.authenticated) return true    // workspace token はそのまま有効
  const keys = context.config.api_keys                    // [functions.config] から
  if (Array.isArray(keys) && keys.includes(request.headers['x-api-key'])) return true
  return { ok: false, status: 401, error: 'Invalid or missing API key' }
}