Logging & crash breadcrumbs

Optional developer logging and support blobs for the TheStage Apple SDK. Security / encryption internals are never included in these surfaces.

Session logfile + terminal

let url = FileManager.default.temporaryDirectory
    .appendingPathComponent("thestage-session.log")
try TheStageAI.start_session_log(to: url, level: .debug, tee_console: true)
// … run …
let path = TheStageAI.end_session_log()

Or install sinks yourself:

TheStageAI.set_developer_log_sink(TheStagePrintLogSink())
TheStageAI.log_level = .debug

Crash / support reports

let json = TheStageAI.user_breadcrumbs_json()
let text = await TheStageAI.debugReport()

Attach either blob to Crashlytics, Sentry, or a support ticket. Paths are redacted; prompts and security details are omitted.

Flutter

TheStageFlutterSDK.initialize prints SDK developer logs in flutter run via the plugin log channel. Security / encryption internals are never included.

Agent checklist

  • Use session log / debugReport for support; never ask users for API tokens.

  • Expect redacted paths.