@abstractframework/assistant 0.0.0-stage → 0.1.0

package/dist/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
+    <meta name="color-scheme" content="light dark" />
+    <meta name="description" content="AbstractAssistant in the browser: your conversations with the Assistant, from any device that reaches your gateway." />
+    <title>AbstractAssistant</title>
+    <script type="module" crossorigin src="./assets/index-DqxMtR-3.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-DsiGtjU5.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/llms.txt

@@ -0,0 +1,110 @@
+# AbstractAssistant in your browser
+
+AbstractAssistant is a voice and conversation interface for AbstractGateway. Open
+**Assistant (web)** from Gateway's Apps page or tray Apps menu. Sign in to the same
+Gateway to use your existing conversations. The Gateway runs the agent, keeps
+history and decides tool permissions; closing this page does not cancel a run.
+
+## Start or continue a conversation
+
+Select a conversation from the sidebar, or use New to start one. On a phone, the
+menu button opens Conversations. Search finds loaded conversations by their title.
+Type in the message field and send your question. Replies appear in the conversation.
+Sending a new message interrupts the previous spoken reply. New and switching
+conversations also stop local audio. Opening history does not read it aloud.
+
+The page shows tool approvals and questions inside the conversation when the agent
+needs you. Review the tool and its arguments before allowing it. **Allow once**
+applies to that request. **Allow for this chat**, when available, uses Gateway's
+session policy. **Decide later** postpones the choice and grants no permission.
+Use Review to return to the pending request. Stop ends the current request or playback.
+
+## Automations
+
+**Automations** in the sidebar (behind the menu button on a phone) lists the tasks that run on
+their own: the active ones first, the most recently active at the top, then **Paused** and
+**Archived**, each opening on a click. Each card shows how many times it ran, how often it runs
+and when it runs next; a number marks results you have not seen, and **Needs you** a run that
+waits for you. The archive button asks first; **Restore** under Archived brings one back.
+
+Open an automation to see its latest ten runs as a conversation: what it was asked, then the
+answer. Opening it marks its new results seen. **Run** starts a run now; while one runs, **Stop**
+ends it (the automation keeps its schedule). **Edit** changes its title, its task, whether it is
+active, how often it runs and whether each run builds on its earlier runs (and how much of them
+it reads); a change made elsewhere meanwhile is refused, so open it again. Type in the message
+field to talk about its latest run: this opens a new conversation about it and never changes
+the automation. When a run asks to use a tool, its page shows the request: **Approve** or **Deny**
+it, or **Approve all** to allow those tools for this automation's runs. They are listed under
+**Allowed for its runs**, and this browser approves them when it sees them, until **Ask again**.
+Another kind of request opens with **Answer**, where you can review it.
+
+**New** creates one: what it should do, the flow that runs it (the gateway's default unless you
+choose another), its **Tools** (each Off, Ask or Auto; a tool on Ask waits for you), how often it
+runs or every day at a time, and whether each run builds on the earlier ones.
+
+## Speak and listen
+
+Tap the orb to begin recording, then tap again to finish. With Hold selected in
+Voice settings, hold the orb to record and release it to finish. The browser needs
+microphone permission and a secure page: HTTPS, localhost or 127.0.0.1. A plain
+HTTP page on another machine cannot use the microphone.
+
+By default, recognized words go into the draft so you can correct them. Enable
+**Send what you say automatically** to submit recognized words directly. Microphone
+mode, input device and available transcription settings are under Settings → Voice.
+The browser records locally; Gateway handles transcription through its configured
+speech capability. This is explicit recording, not an always-listening wake word.
+
+Enable **Read new replies aloud** using the speaker control or Voice settings.
+It reads new replies from this tab's requests. Use the orb or pause/play control
+to pause or resume a selected reply; Stop ends it. A message's speaker control
+reads that message on demand. In Voice settings, choose the speaking route and
+voice offered by Gateway, or keep its default. Available voices and capabilities
+depend on Gateway's installed providers. Browser autoplay rules can require a
+click before playback is allowed.
+
+## Appearance and avatars
+
+Settings lets you select an avatar and preview Ready, Listening, Thinking, Working,
+Speaking, Waiting and Error silently. Watch particle forms, the iPhone woven orb
+and shaded characters remain separate choices. Preview sample loudness does not
+record or play audio. Your choice applies immediately. The animation switch and
+your system's reduced-motion preference control motion. Hidden pages stop animating.
+Avatars with eyes, such as the Hover robot and the Rover, look toward your mouse while
+Ready; the orb and every other avatar stay still.
+The top-bar appearance button changes the theme.
+
+Listening reacts to measured microphone loudness. Speaking reacts to the reply's
+actual playback level after volume and mute. Pauses and silence produce zero
+voice level; the avatar never invents a voice signal to appear active.
+
+Ready means the assistant is available. Listening means recording. Thinking and
+Working reflect the current request. Speaking follows reply playback. Waiting
+means an approval or answer needs you. Error indicates a failed action. The avatar
+is a visual representation; it does not run an independent agent.
+
+## Documentation and conversation details
+
+The book button opens the Docs assistant. Ask how to use the browser Assistant;
+answers are grounded in this guide. Docs has its own conversation and does not
+automatically see or control your main conversation, files or tools. Use New
+conversation in its header to start a fresh documentation chat, or Past
+conversations to reopen one. Its question field stays at the bottom while messages
+scroll above it. Attachment availability depends on Gateway.
+
+Details in the main conversation reveals optional usage, timing and delivery
+diagnostics. A structured-output model call may return its text all at once;
+this does not mean the reply failed. Errors and pending approvals remain visible.
+Copy and export controls use the conversation loaded in the page.
+
+## Settings, privacy and limitations
+
+Gateway owns sign-in, conversations, workflows, model routing and permissions.
+This browser keeps appearance, voice and panel preferences locally. Selecting an
+avatar does not change an entity's shared identity or voice on other devices.
+Use the same Gateway account across clients to access the same conversations.
+
+The desktop, iPhone and Watch apps have their
+own interfaces; a native-only feature is not automatically available here.
+An unavailable workflow, voice route or connection must be configured on Gateway.
+If disconnected, check Gateway connectivity and sign-in before retrying.

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@abstractframework/assistant",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "AbstractAssistant for the web: chat or talk with the Assistant in a browser, with live answers, approvals, dictation and read aloud. A thin client of AbstractGateway, served at /apps/assistant-web/.",
+  "keywords": [
+    "abstractframework",
+    "assistant",
+    "chat",
+    "voice",
+    "gateway",
+    "ui"
+  ],
+  "homepage": "https://github.com/lpalbou/AbstractAssistant/tree/main/web#readme",
+  "bugs": {
+    "url": "https://github.com/lpalbou/AbstractAssistant/issues"
+  },
+  "type": "module",
+  "author": "Laurent-Philippe Albou",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lpalbou/AbstractAssistant.git",
+    "directory": "web"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "abstractassistant-web": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "bin",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite --port 3008",
+    "build": "node scripts/sync_conversation.mjs --check && node scripts/sync_sessions.mjs --check && node scripts/sync_gateway_voice.mjs --check && node scripts/sync_apple_avatars.mjs --check && node scripts/sync_docs_assistant.mjs --check && tsc && vite build && node scripts/build_docs_corpus.mjs && node scripts/check_relative_urls.mjs --dist",
+    "check:urls": "node scripts/check_relative_urls.mjs",
+    "start": "node ./bin/cli.js",
+    "test": "vitest run",
+    "test:layout": "node scripts/check_layout.mjs",
+    "test:experience": "node scripts/check_experience.mjs",
+    "sync:avatars": "node scripts/sync_apple_avatars.mjs",
+    "sync:docs": "node scripts/sync_docs_assistant.mjs",
+    "sync:voice": "node scripts/sync_gateway_voice.mjs",
+    "sync:sessions": "node scripts/sync_sessions.mjs",
+    "sync:conversation": "node scripts/sync_conversation.mjs",
+    "check:package": "node scripts/check_package.mjs",
+    "prepublishOnly": "npm run build && node scripts/check_package.mjs"
+  },
+  "dependencies": {
+    "@abstractframework/app-server": "^0.1.13"
+  },
+  "devDependencies": {
+    "@abstractframework/panel-chat": "^0.8.1",
+    "@abstractframework/ui-kit": "^0.9.14",
+    "@types/react": "18.3.27",
+    "@types/react-dom": "18.3.7",
+    "@vitejs/plugin-react": "4.7.0",
+    "playwright": "1.63.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.9.3",
+    "vite": "6.4.3",
+    "vitest": "5.0.4"
+  }
+}