@omnivoice/page-agent 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnivoice/page-agent",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "GUI agent for web applications - add intelligent automation to any webpage with a single script, with an optional realtime voice module",
   "keywords": [
     "ai",
@@ -65,6 +65,8 @@
     "test:consumer": "node scripts/verify-consumer.mjs",
     "test:voice": "node --experimental-strip-types --no-warnings --test tests/voice/core.test.ts tests/voice/realtime-engine.test.ts && tsc -p tests/voice/tsconfig.json",
     "test:voice-browser": "node --experimental-strip-types --no-warnings --test tests/voice/browser-audio.test.ts",
+    "test:brain": "node --experimental-strip-types --no-warnings --test tests/brain/policy.test.ts && tsc -p tests/brain/tsconfig.json",
+    "test:brain-e2e": "node --experimental-strip-types --no-warnings --test tests/brain/e2e.test.ts && tsc -p tests/brain/tsconfig.json",
     "prepack": "node scripts/build-package.mjs && node scripts/verify-package.mjs",
     "prepublishOnly": "node scripts/build-package.mjs && node scripts/verify-package.mjs --release",
     "dev": "vite --host 127.0.0.1",
@@ -92,7 +94,7 @@
     "test:vendor-wiring": "node scripts/verify-vendor-wiring.mjs",
     "test:fork": "node scripts/verify-fork-customizations.mjs",
     "test:vendor-bundle": "node scripts/verify-vendor-bundle.mjs",
-    "test:all": "npm run test:vendor-provenance && npm run test:vendor && npm run test:vendor-wiring && npm run test:vendor-bundle && npm run test:fork && npm run test:contract && npm run test:session && npm run test:surface && npm run test:guard && npm run test:routine && npm run test:runner && npm run test:compactor && npm run test:condition && npm run test:record && npm run test:espera && npm run test:chess && npm run test:schemas && npm run test:gateway && npm run test:voice",
+    "test:all": "npm run test:vendor-provenance && npm run test:vendor && npm run test:vendor-wiring && npm run test:vendor-bundle && npm run test:fork && npm run test:contract && npm run test:session && npm run test:surface && npm run test:guard && npm run test:routine && npm run test:runner && npm run test:compactor && npm run test:condition && npm run test:record && npm run test:espera && npm run test:chess && npm run test:schemas && npm run test:gateway && npm run test:voice && npm run test:brain && npm run build:package && npm run test:consumer && npm run test:voice-browser && npm run test:brain-e2e",
     "test:gateway": "node scripts/verify-agent-gateway.mjs"
   },
   "dependencies": {

package/server/agent-gateway.mjs

@@ -16,6 +16,12 @@
  *   AGENT_VOICE_INPUT  true/false — permite ditado no widget (default true)
  *   AGENT_VOICE_OUTPUT true/false — agente fala o resultado (default false)
  *   AGENT_VOICE_LANG   Idioma da voz (default = AGENT_LANGUAGE)
+ *   AGENT_INSTRUCTIONS Texto de instruções de sistema enviado ao widget em /config (opcional; até 8 KB).
+ *                      Serve p/ regras como somente-leitura ou antirrepetição. Campo `instructions` (string) no JSON.
+ *   AGENT_BRAIN        on/off — pede ao widget que ligue o segundo cérebro (default off). O gateway só
+ *                      repassa o sinal; quem o implementa é o widget. Campo `brain` no JSON.
+ *   AGENT_DEBUG        on/off — pede ao widget que registre o diagnóstico por passo (default off).
+ *                      Campo `debug` no JSON.
  *   AGENT_PORT         Porta do gateway (default 8790)
  *   AGENT_HOST         Bind (default 127.0.0.1 — local; use 0.0.0.0 só atrás de proxy seguro)
  *   AGENT_CONFIG       Caminho p/ um agent.config.json com os mesmos campos (case-insensitive).
@@ -58,6 +64,9 @@ function envBool(v, def) {
 	return ['1', 'true', 'yes', 'on'].includes(String(v).toLowerCase())
 }
 
+// Limite do texto de instruções: vai em TODA resposta de /config e entra no prompt do modelo.
+const MAX_INSTRUCTIONS_BYTES = 8 * 1024
+
 const fileCfg = loadFileConfig()
 const pick = (envKey, fileKey, def) => {
 	const fromEnv = process.env[envKey]
@@ -67,6 +76,23 @@ const pick = (envKey, fileKey, def) => {
 	return def
 }
 
+// Instruções de sistema opcionais. Só texto: um valor que não é string é ignorado com aviso, e o que
+// passa do limite derruba o start (melhor falhar alto que cortar uma regra de segurança pela metade).
+function readInstructions() {
+	const raw = pick('AGENT_INSTRUCTIONS', 'instructions', '')
+	if (typeof raw !== 'string') {
+		console.warn('[gateway] `instructions` deve ser texto; valor ignorado')
+		return ''
+	}
+	const text = raw.trim()
+	const bytes = Buffer.byteLength(text, 'utf8')
+	if (bytes > MAX_INSTRUCTIONS_BYTES) {
+		console.error(`[gateway] AGENT_INSTRUCTIONS tem ${bytes} bytes; o limite é ${MAX_INSTRUCTIONS_BYTES}`)
+		process.exit(1)
+	}
+	return text
+}
+
 const config = {
 	baseURL: String(pick('AGENT_BASE_URL', 'baseURL', '')).replace(/\/+$/, ''),
 	apiKey: String(pick('AGENT_API_KEY', 'apiKey', '')),
@@ -79,6 +105,9 @@ const config = {
 		lang: String(pick('AGENT_VOICE_LANG', 'voiceLang', '')) || undefined,
 	},
 	promptForNextTask: envBool(pick('AGENT_PROMPT_NEXT', 'promptForNextTask', 'true'), true),
+	instructions: readInstructions(),
+	brain: envBool(pick('AGENT_BRAIN', 'brain', 'false'), false),
+	debug: envBool(pick('AGENT_DEBUG', 'debug', 'false'), false),
 	port: Number(pick('AGENT_PORT', 'port', 8790)) || 8790,
 	host: String(pick('AGENT_HOST', 'host', '127.0.0.1')),
 }
@@ -107,6 +136,9 @@ function publicConfig() {
 			output: config.voice.output,
 			...(config.voice.lang && { lang: config.voice.lang }),
 		},
+		brain: config.brain,
+		debug: config.debug,
+		...(config.instructions && { instructions: { system: config.instructions } }),
 	}
 }
 
@@ -210,6 +242,7 @@ const server = createServer(async (req, res) => {
 server.listen(config.port, config.host, () => {
 	console.log(`[gateway] agente ouvindo em http://${config.host}:${config.port}`)
 	console.log(`[gateway]   model=${config.model}  language=${config.language}  voice=${JSON.stringify(config.voice)}`)
+	console.log(`[gateway]   brain=${config.brain}  debug=${config.debug}  instructions=${config.instructions ? `${Buffer.byteLength(config.instructions, 'utf8')} bytes` : 'não'}`)
 	console.log(`[gateway]   chave configurada: ${config.apiKey ? 'sim (mantida no servidor)' : 'NÃO — defina AGENT_API_KEY'}`)
 	console.log(`[gateway]   upstream: ${config.baseURL || '(não definido)'}`)
 })