bump upstream to 0.4.1, add the status page UI, fix CI branch triggers

Community-registry audit ahead of listing.

Upstream 0.4.1 renames the model catalog (private/kimi-k2-6 →
private/kimi-k3, drops qwen3-vl-30b) and serves a status page at GET /,
so the package was documenting a stale model list and hiding a whole
surface. Export that page as a `ui` interface alongside the existing
`api` on one host, and unmask the API interface — its URL carries no
credentials, so masking hid the address for nothing.

PPQ_DATA_DIR stays unset deliberately. With it set, upstream persists a
browser-entered key to its own config.json while the StartOS-supplied
PPQ_API_KEY still wins at every restart, silently reverting the user.
StartOS owns the key via the action; the status page's form renders
disabled.

CI never ran: build.yml's PR target and tagAndRelease.yml's push
trigger both named `master` on a repo whose only branch is `main`.
Point them at `main` and reset all three workflows to the package
template, dropping the guard job retired in start-technologies@ed0dca2.

packageRepo now names the Start9-Community fork, which is where CI
runs, where the org's registry variables live, and where releases are
cut.

Also: drop three .catch handlers on file-model reads, which swallowed a
genuine read failure into "no key configured" — readOnce already
returns null for a missing file; pass null rather than an empty Mounts
for the unmounted subcontainer; inline two single-use interface consts;
and rewrite README/instructions against the writing guides, fixing a
YAML block that claimed a /data mount the package deliberately does not
make.
This commit is contained in:
helix-nine committed 2026-08-12 09:58:35 -06:00
1 parent 5146a2670f
commit 42b2841945
17 files changed
+204 -168

No files matched your search

+9 -14
View File
@@ -41,24 +41,19 @@ export const configureApiKey = sdk.Action.withInput(
inputSpec,
// Prefill: the API key is never echoed back into the form.
async ({ effects }) => {
const debug = await configJson
.read((c) => c.debug)
.once()
.catch(() => false)
return { debug: debug ?? false }
},
async ({ effects }) => ({
debug: (await configJson.read((c) => c.debug).once()) ?? false,
}),
async ({ effects, input }) => {
const existingKey = await configJson
.read((c) => c.apiKey)
.once()
.catch(() => undefined)
const apiKey = (input.apiKey ?? '').trim() || existingKey
const apiKey =
(input.apiKey ?? '').trim() ||
(await configJson.read((c) => c.apiKey).once())
if (!apiKey) {
throw new Error(
i18n('An API key is required. Create one at ppq.ai under Settings → API Keys.'),
i18n(
'An API key is required. Create one at ppq.ai under Settings → API Keys.',
),
)
}
+12 -10
View File
@@ -7,18 +7,20 @@ const dict = {
'The proxy is ready — enclave attestation verified': 2,
'The proxy is not ready (enclave attestation pending)': 3,
// interfaces.ts
'OpenAI-Compatible API': 4,
'Point any OpenAI or Anthropic SDK client at this URL to use PPQ private (TEE) models with end-to-end encryption': 5,
'Status Page': 4,
'Enclave attestation state, the available private models, and client setup snippets': 5,
'OpenAI-Compatible API': 6,
'Point any OpenAI or Anthropic SDK client at this URL to use PPQ private (TEE) models with end-to-end encryption': 7,
// actions/configureApiKey.ts
'PPQ.AI API Key': 6,
'Your API key from ppq.ai (Settings → API Keys). Leave blank to keep the key already saved.': 7,
'Verbose Logging': 8,
'Log every request the proxy handles. Useful for troubleshooting.': 9,
'Configure PPQ API Key': 10,
'Set the PPQ.AI API key the proxy uses to authenticate. Requests are billed to this key.': 11,
'An API key is required. Create one at ppq.ai under Settings → API Keys.': 12,
'PPQ.AI API Key': 8,
'Your API key from ppq.ai (Settings → API Keys). Leave blank to keep the key already saved.': 9,
'Verbose Logging': 10,
'Log every request the proxy handles. Useful for troubleshooting.': 11,
'Configure PPQ API Key': 12,
'Set the PPQ.AI API key the proxy uses to authenticate. Requests are billed to this key.': 13,
'An API key is required. Create one at ppq.ai under Settings → API Keys.': 14,
// init/taskConfigureApiKey.ts
'Add your PPQ.AI API key to start the proxy': 13,
'Add your PPQ.AI API key to start the proxy': 15,
} as const
/**
+48 -40
View File
@@ -6,63 +6,71 @@ export default {
1: 'Proxy cifrado',
2: 'El proxy está listo — atestación del enclave verificada',
3: 'El proxy no está listo (atestación del enclave pendiente)',
4: 'API compatible con OpenAI',
5: 'Apunta cualquier cliente SDK de OpenAI o Anthropic a esta URL para usar los modelos privados (TEE) de PPQ con cifrado de extremo a extremo',
6: 'Clave API de PPQ.AI',
7: 'Tu clave API de ppq.ai (Ajustes → Claves API). Déjalo en blanco para conservar la clave ya guardada.',
8: 'Registro detallado',
9: 'Registra cada solicitud que maneja el proxy. Útil para diagnosticar problemas.',
10: 'Configurar clave API de PPQ',
11: 'Establece la clave API de PPQ.AI que el proxy usa para autenticarse. Las solicitudes se facturan a esta clave.',
12: 'Se requiere una clave API. Crea una en ppq.ai en Ajustes → Claves API.',
13: 'Añade tu clave API de PPQ.AI para iniciar el proxy',
4: 'Página de estado',
5: 'Estado de la atestación del enclave, los modelos privados disponibles y fragmentos de configuración para clientes',
6: 'API compatible con OpenAI',
7: 'Apunta cualquier cliente SDK de OpenAI o Anthropic a esta URL para usar los modelos privados (TEE) de PPQ con cifrado de extremo a extremo',
8: 'Clave API de PPQ.AI',
9: 'Tu clave API de ppq.ai (Ajustes → Claves API). Déjalo en blanco para conservar la clave ya guardada.',
10: 'Registro detallado',
11: 'Registra cada solicitud que maneja el proxy. Útil para diagnosticar problemas.',
12: 'Configurar clave API de PPQ',
13: 'Establece la clave API de PPQ.AI que el proxy usa para autenticarse. Las solicitudes se facturan a esta clave.',
14: 'Se requiere una clave API. Crea una en ppq.ai en Ajustes → Claves API.',
15: 'Añade tu clave API de PPQ.AI para iniciar el proxy',
},
de_DE: {
0: 'Starte PPQ Private Mode!',
1: 'Verschlüsselter Proxy',
2: 'Der Proxy ist bereit — Enklave-Attestierung verifiziert',
3: 'Der Proxy ist nicht bereit (Enklave-Attestierung ausstehend)',
4: 'OpenAI-kompatible API',
5: 'Verbinde jeden OpenAI- oder Anthropic-SDK-Client mit dieser URL, um die privaten (TEE) Modelle von PPQ mit Ende-zu-Ende-Verschlüsselung zu nutzen',
6: 'PPQ.AI-API-Schlüssel',
7: 'Dein API-Schlüssel von ppq.ai (Einstellungen → API-Schlüssel). Leer lassen, um den bereits gespeicherten Schlüssel zu behalten.',
8: 'Ausführliche Protokollierung',
9: 'Protokolliert jede Anfrage, die der Proxy verarbeitet. Nützlich zur Fehlersuche.',
10: 'PPQ-API-Schlüssel konfigurieren',
11: 'Lege den PPQ.AI-API-Schlüssel fest, mit dem sich der Proxy authentifiziert. Anfragen werden diesem Schlüssel in Rechnung gestellt.',
12: 'Ein API-Schlüssel ist erforderlich. Erstelle einen auf ppq.ai unter Einstellungen → API-Schlüssel.',
13: 'Füge deinen PPQ.AI-API-Schlüssel hinzu, um den Proxy zu starten',
4: 'Statusseite',
5: 'Status der Enklave-Attestierung, die verfügbaren privaten Modelle und Codeschnipsel zur Client-Einrichtung',
6: 'OpenAI-kompatible API',
7: 'Verbinde jeden OpenAI- oder Anthropic-SDK-Client mit dieser URL, um die privaten (TEE) Modelle von PPQ mit Ende-zu-Ende-Verschlüsselung zu nutzen',
8: 'PPQ.AI-API-Schlüssel',
9: 'Dein API-Schlüssel von ppq.ai (Einstellungen → API-Schlüssel). Leer lassen, um den bereits gespeicherten Schlüssel zu behalten.',
10: 'Ausführliche Protokollierung',
11: 'Protokolliert jede Anfrage, die der Proxy verarbeitet. Nützlich zur Fehlersuche.',
12: 'PPQ-API-Schlüssel konfigurieren',
13: 'Lege den PPQ.AI-API-Schlüssel fest, mit dem sich der Proxy authentifiziert. Anfragen werden diesem Schlüssel in Rechnung gestellt.',
14: 'Ein API-Schlüssel ist erforderlich. Erstelle einen auf ppq.ai unter Einstellungen → API-Schlüssel.',
15: 'Füge deinen PPQ.AI-API-Schlüssel hinzu, um den Proxy zu starten',
},
pl_PL: {
0: 'Uruchamianie PPQ Private Mode!',
1: 'Szyfrowany proxy',
2: 'Proxy jest gotowy — atestacja enklawy zweryfikowana',
3: 'Proxy nie jest gotowy (atestacja enklawy w toku)',
4: 'API zgodne z OpenAI',
5: 'Skieruj dowolnego klienta SDK OpenAI lub Anthropic na ten URL, aby korzystać z prywatnych modeli (TEE) PPQ z szyfrowaniem end-to-end',
6: 'Klucz API PPQ.AI',
7: 'Twój klucz API z ppq.ai (Ustawienia → Klucze API). Pozostaw puste, aby zachować już zapisany klucz.',
8: 'Szczegółowe logowanie',
9: 'Rejestruje każde żądanie obsługiwane przez proxy. Przydatne przy rozwiązywaniu problemów.',
10: 'Skonfiguruj klucz API PPQ',
11: 'Ustaw klucz API PPQ.AI, którym proxy się uwierzytelnia. Żądania są rozliczane na ten klucz.',
12: 'Wymagany jest klucz API. Utwórz go na ppq.ai w Ustawienia → Klucze API.',
13: 'Dodaj swój klucz API PPQ.AI, aby uruchomić proxy',
4: 'Strona stanu',
5: 'Stan atestacji enklawy, dostępne modele prywatne oraz fragmenty konfiguracji dla klientów',
6: 'API zgodne z OpenAI',
7: 'Skieruj dowolnego klienta SDK OpenAI lub Anthropic na ten URL, aby korzystać z prywatnych modeli (TEE) PPQ z szyfrowaniem end-to-end',
8: 'Klucz API PPQ.AI',
9: 'Twój klucz API z ppq.ai (Ustawienia → Klucze API). Pozostaw puste, aby zachować już zapisany klucz.',
10: 'Szczegółowe logowanie',
11: 'Rejestruje każde żądanie obsługiwane przez proxy. Przydatne przy rozwiązywaniu problemów.',
12: 'Skonfiguruj klucz API PPQ',
13: 'Ustaw klucz API PPQ.AI, którym proxy się uwierzytelnia. Żądania są rozliczane na ten klucz.',
14: 'Wymagany jest klucz API. Utwórz go na ppq.ai w Ustawienia → Klucze API.',
15: 'Dodaj swój klucz API PPQ.AI, aby uruchomić proxy',
},
fr_FR: {
0: 'Démarrage de PPQ Private Mode !',
1: 'Proxy chiffré',
2: "Le proxy est prêt — attestation de l'enclave vérifiée",
3: "Le proxy n'est pas prêt (attestation de l'enclave en attente)",
4: 'API compatible OpenAI',
5: "Pointez n'importe quel client SDK OpenAI ou Anthropic vers cette URL pour utiliser les modèles privés (TEE) de PPQ avec un chiffrement de bout en bout",
6: 'Clé API PPQ.AI',
7: 'Votre clé API de ppq.ai (Paramètres → Clés API). Laissez vide pour conserver la clé déjà enregistrée.',
8: 'Journalisation détaillée',
9: 'Journalise chaque requête traitée par le proxy. Utile pour le dépannage.',
10: 'Configurer la clé API PPQ',
11: "Définissez la clé API PPQ.AI avec laquelle le proxy s'authentifie. Les requêtes sont facturées sur cette clé.",
12: 'Une clé API est requise. Créez-en une sur ppq.ai dans Paramètres → Clés API.',
13: 'Ajoutez votre clé API PPQ.AI pour démarrer le proxy',
4: "Page d'état",
5: "État de l'attestation de l'enclave, les modèles privés disponibles et des extraits de configuration client",
6: 'API compatible OpenAI',
7: "Pointez n'importe quel client SDK OpenAI ou Anthropic vers cette URL pour utiliser les modèles privés (TEE) de PPQ avec un chiffrement de bout en bout",
8: 'Clé API PPQ.AI',
9: 'Votre clé API de ppq.ai (Paramètres → Clés API). Laissez vide pour conserver la clé déjà enregistrée.',
10: 'Journalisation détaillée',
11: 'Journalise chaque requête traitée par le proxy. Utile pour le dépannage.',
12: 'Configurer la clé API PPQ',
13: "Définissez la clé API PPQ.AI avec laquelle le proxy s'authentifie. Les requêtes sont facturées sur cette clé.",
14: 'Une clé API est requise. Créez-en une sur ppq.ai dans Paramètres → Clés API.',
15: 'Ajoutez votre clé API PPQ.AI pour démarrer le proxy',
},
} satisfies Record<string, LangDict>
+2 -5
View File
@@ -5,11 +5,8 @@ import { i18n } from '../i18n'
// The proxy cannot start without a PPQ.AI API key, so a critical task blocks
// startup until the user provides one.
export const taskConfigureApiKey = sdk.setupOnInit(async (effects, kind) => {
const apiKey = await configJson
.read((c) => c.apiKey)
.once()
.catch(() => undefined)
export const taskConfigureApiKey = sdk.setupOnInit(async (effects) => {
const apiKey = await configJson.read((c) => c.apiKey).once()
if (!apiKey) {
await sdk.action.createOwnTask(effects, configureApiKey, 'critical', {
+19 -10
View File
@@ -2,30 +2,39 @@ import { sdk } from './sdk'
import { apiPort } from './utils'
import { i18n } from './i18n'
// Host id (the sdk.MultiHost.of group) — distinct from the interface id exported on it.
export const apiHostId = 'api-multi'
export const apiInterfaceId = 'api'
export const setInterfaces = sdk.setupInterfaces(async ({ effects }) => {
const apiMulti = sdk.MultiHost.of(effects, apiHostId)
const apiMultiOrigin = await apiMulti.bindPort(apiPort, {
const multi = sdk.MultiHost.of(effects, 'main')
const origin = await multi.bindPort(apiPort, {
protocol: 'http',
})
const ui = sdk.createInterface(effects, {
name: i18n('Status Page'),
id: 'ui',
description: i18n(
'Enclave attestation state, the available private models, and client setup snippets',
),
type: 'ui',
masked: false,
schemeOverride: null,
username: null,
path: '',
query: {},
})
const api = sdk.createInterface(effects, {
name: i18n('OpenAI-Compatible API'),
id: apiInterfaceId,
id: 'api',
description: i18n(
'Point any OpenAI or Anthropic SDK client at this URL to use PPQ private (TEE) models with end-to-end encryption',
),
type: 'api',
masked: true,
masked: false,
schemeOverride: null,
username: null,
path: '',
query: {},
})
const apiReceipt = await apiMultiOrigin.export([api])
const receipt = await origin.export([ui, api])
return [apiReceipt]
return [receipt]
})
+7 -3
View File
@@ -17,7 +17,7 @@ export const main = sdk.setupMain(async ({ effects }) => {
subcontainer: sdk.SubContainer.of(
effects,
{ imageId: 'proxy' },
sdk.Mounts.of(),
null,
'proxy-sub',
),
exec: {
@@ -36,8 +36,12 @@ export const main = sdk.setupMain(async ({ effects }) => {
display: i18n('Encrypted Proxy'),
fn: () =>
sdk.healthCheck.checkPortListening(effects, apiPort, {
successMessage: i18n('The proxy is ready — enclave attestation verified'),
errorMessage: i18n('The proxy is not ready (enclave attestation pending)'),
successMessage: i18n(
'The proxy is ready — enclave attestation verified',
),
errorMessage: i18n(
'The proxy is not ready (enclave attestation pending)',
),
}),
},
requires: [],
+6 -3
View File
@@ -1,9 +1,12 @@
export const short = {
en_US: 'End-to-end encrypted proxy for PPQ.AI private (TEE) AI models',
es_ES: 'Proxy cifrado de extremo a extremo para los modelos de IA privados (TEE) de PPQ.AI',
de_DE: 'Ende-zu-Ende-verschlüsselter Proxy für private (TEE) KI-Modelle von PPQ.AI',
es_ES:
'Proxy cifrado de extremo a extremo para los modelos de IA privados (TEE) de PPQ.AI',
de_DE:
'Ende-zu-Ende-verschlüsselter Proxy für private (TEE) KI-Modelle von PPQ.AI',
pl_PL: 'Szyfrowany end-to-end proxy dla prywatnych modeli AI (TEE) PPQ.AI',
fr_FR: 'Proxy chiffré de bout en bout pour les modèles IA privés (TEE) de PPQ.AI',
fr_FR:
'Proxy chiffré de bout en bout pour les modèles IA privés (TEE) de PPQ.AI',
}
export const long = {
+1 -1
View File
@@ -5,7 +5,7 @@ export const manifest = setupManifest({
id: 'ppq-private-mode',
title: 'PPQ Private Mode',
license: 'MIT',
packageRepo: 'https://github.com/PayPerQ/ppq-private-mode-startos',
packageRepo: 'https://github.com/Start9-Community/ppq-private-mode-startos',
upstreamRepo: 'https://github.com/PayPerQ/ppq-private-mode-proxy',
marketingUrl: 'https://ppq.ai',
donationUrl: null,
+1 -1
View File
@@ -2,7 +2,7 @@ import { IMPOSSIBLE, VersionInfo } from '@start9labs/start-sdk'
export const current = VersionInfo.of({
// Tracks upstream ppq-private-mode-proxy (package.json version).
version: '0.3.2:0',
version: '0.4.1:0',
releaseNotes: {
en_US: 'Initial release for StartOS',
es_ES: 'Lanzamiento inicial para StartOS',