Vegard Stikbakke vegarsti

S3 File Storage: Current State & Plan

Where files are stored in S3

All files go to the lefos-conversations-dev bucket (config: CONVERSATION_BUCKET), with one shared S3 client at packages/elwing/src/s3/client.ts.

S3 key hierarchy:

{domainId}/{mailboxId}/{conversationId}/
├── artifacts/{filename} # Agent-produced files

Elwing Billing System — Data Flow Summary

Elwing uses Polar (polar.sh) as its billing/subscription provider. Billing is credit-based: users purchase subscriptions or top-ups via Polar, receive credits, and credits are consumed as the AI agent processes emails, chats, and memory operations.

Key Concepts

Concept	Description
Credits	Internal currency. Converted from token cost: `credits = tokenCents × 12.5`
Billing Owner	Each space has one billing owner (user). All charges in that space bill to them.

Session Storage Record Examples

Each example shows the concrete conversation_records rows written per trigger type. All examples use conv_ABC as the conversation ID.

Common: Session Root

Written once per conversation (lazily, on first trigger). All subsequent main-thread

Session State Migration Plan

Move all session state out of Absurd checkpoint tables into our own database, enabling conversation replay and forking from conversation_records + a new session table.

Phase 1 — Refactors (no DB changes)

1a. Move DB recording inside `ctx.step`

Get package on PyPi (so you can `pip install` it)

Guide to PyPi
Guide to writing a package (vboykis)
Documentation in .rst format: pandoc --from=markdown --to=rst --output=README.rst README.md
https://gehrcke.de/2014/02/distributing-a-python-command-line-application/
http://kronosapiens.github.io/blog/2014/07/28/understanding-package-imports-in-python.html imports
https://hynek.me/articles/sharing-your-labor-of-love-pypi-quick-and-dirty/#fnref:meta-peps
rst check: http://rst.ninjs.org

	import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";

	export default function (pi: ExtensionAPI) {
	pi.on("session_start", async (_event, ctx) => {
	ctx.ui.setFooter((tui) => {
	const interval = setInterval(() => tui.requestRender(), 100);
	return {
	dispose: () => clearInterval(interval),
	invalidate() {},
	render(): string[] {

	#include <sys/event.h>
	#include <sys/time.h>
	#include <fcntl.h>
	#include <stdio.h>
	#include <stdlib.h>
	#include <unistd.h>

	// Watches files for changes and prints which file changed
	int main(int argc, char *argv[]) {
	if (argc < 2) {

	https://twitter.com/thorstenball/status/1576619567488475137?s=20&t=KaBdUrc5-M1bnNTMU6tuQA

	Working with Unix Processes
	Working with TCP Sockets
	Working with Ruby Threads
	Zed Shaw's C book
	Programming From The Ground Up
	Destroy All Software
	PeepCode Play by Play
	Pragmatic Programmer

	# If you come from bash you might have to change your $PATH.
	# export PATH=$HOME/bin:/usr/local/bin:$PATH

	# Path to your oh-my-zsh installation.
	export ZSH=/Users/vegard/.oh-my-zsh

	# Set name of the theme to load. Optionally, if you set this to "random"
	# it'll load a random theme each time that oh-my-zsh is loaded.
	# See https://github.com/robbyrussell/oh-my-zsh/wiki/Themes
	ZSH_THEME="sobole"

	Install Karabiner Elements.
	Follow this
	https://github.com/tekezo/Karabiner-Elements/issues/638