mozaiks 0.1.0__tar.gz

mozaiks-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BlocUnited LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mozaiks-0.1.0/MANIFEST.in

@@ -0,0 +1,18 @@
+recursive-include factory_app/app *
+recursive-include factory_app/capability_packs *
+recursive-include factory_app/workflows *
+recursive-include web_shell *.js *.jsx *.css *.html *.json *.md
+include web_shell/.env.example
+recursive-include chat-ui/src *
+include chat-ui/package.json
+include chat-ui/package-lock.json
+include chat-ui/postcss.config.js
+include chat-ui/tailwind.config.js
+include chat-ui/tsconfig.json
+include chat-ui/vite.embed.config.js
+include chat-ui/README.md
+prune web_shell/node_modules
+prune web_shell/dist
+prune web_shell/test-results
+prune web_shell/playwright-report
+global-exclude *.py[cod]

mozaiks-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: mozaiks
+Version: 0.1.0
+Summary: Mozaiks AG2 runtime and Studio-driven app framework
+Author-email: BlocUnited LLC <mike@blocunited.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/BlocUnited-LLC/mozaiks
+Project-URL: Repository, https://github.com/BlocUnited-LLC/mozaiks
+Project-URL: Documentation, https://github.com/BlocUnited-LLC/mozaiks#readme
+Keywords: mozaiks,ag2,autogen,ai,agents,workflows,multi-tenant,runtime
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ag2[a2a,lmm,openai]>=0.11.5
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn[standard]>=0.20.0
+Requires-Dist: websockets>=11.0
+Requires-Dist: motor>=3.3.0
+Requires-Dist: pymongo>=4.5.0
+Requires-Dist: dnspython>=2.4.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: PyJWT[crypto]>=2.8.0
+Requires-Dist: jinja2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: limits>=3.6.0
+Requires-Dist: jsonschema>=4.0.0
+Provides-Extra: azure
+Requires-Dist: azure-identity>=1.15.0; extra == "azure"
+Requires-Dist: azure-keyvault-secrets>=4.7.0; extra == "azure"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: watchdog; extra == "dev"
+Provides-Extra: tracing
+Requires-Dist: opentelemetry-sdk>=1.27.0; extra == "tracing"
+Requires-Dist: opentelemetry-exporter-otlp>=1.27.0; extra == "tracing"
+Provides-Extra: tree-sitter
+Requires-Dist: tree-sitter>=0.20.0; extra == "tree-sitter"
+Requires-Dist: tree-sitter-python; extra == "tree-sitter"
+Requires-Dist: tree-sitter-javascript; extra == "tree-sitter"
+Requires-Dist: tree-sitter-css; extra == "tree-sitter"
+Provides-Extra: e2b
+Requires-Dist: e2b-code-interpreter>=0.0.10; extra == "e2b"
+Dynamic: license-file
+
+# Mozaiks
+
+<div align="center">
+
+<img src="./docs/assets/mozaik_logo.svg" alt="Mozaiks Logo" width="180"/>
+
+[![Release](https://img.shields.io/github/v/release/BlocUnited-LLC/mozaiks)](https://github.com/BlocUnited-LLC/mozaiks/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11+-blue?logo=python)](https://www.python.org/)
+[![AG2](https://img.shields.io/badge/AG2-Autogen-green)](https://github.com/ag2ai/ag2)
+
+</div>
+
+## 🎯 What is MozaiksAI?
+Declarative orchestration runtime and Studio-driven app framework for AG2 (formerly Microsoft Autogen):
+
+- ✅ **Event-Driven Architecture** — Runtime, app, workflow, UI, and hosted events stay separated by contract
+- ✅ **Mid-Flight Journeys (MFJ)** — Run parallel workflows by fork/join with deterministic parent resume
+- ✅ **Real-Time WebSocket Transport** — Live agent streaming to React frontends
+- ✅ **Dynamic UI Integration** — Agents can invoke React components during workflows
+- ✅ **Multi-Tenant Isolation** — App-scoped data and execution contexts
+- ✅ **Declarative Workflows** — YAML manifests, no code changes needed
+- ✅ **Comprehensive Observability** — Built-in metrics, logging, and token tracking
+- ✅ **Persistent State Management** — Resume conversations exactly where they left off
+
+Current recommended setup: clone the repo, create a virtual environment, run
+the builder bootstrap script, and let it open Studio for you.
+
+Builder path:
+
+```powershell
+git clone https://github.com/BlocUnited-LLC/mozaiks.git
+cd mozaiks
+.\scripts\bootstrap-builder.ps1 -Workspace .\my-first-mozaiks-app
+```
+
+Advanced/framework path:
+
+- `mozaiks onboard --full`
+- `mozaiks studio --open`
+- `mozaiks init`
+- `mozaiks serve`
+
+Manual equivalent of the bootstrap path:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+pip install -e .
+mozaiks quickstart --dir ./my-first-mozaiks-app
+```
+
+Current repo layout:
+
+- `web_shell/` - local Vite shell host source
+- `factory_app/app/` - shared Studio app bundle and default brand assets
+- `factory_app/workflows/` - shared builder workflow root
+
+---
+
+## 🎨 See It In Action
+
+<div align="center">
+
+### 💬 Embeddable Floating Widget
+
+![Widget Demo](./docs/assets/widgetAction.gif)
+
+*Drop a floating assistant anywhere in your app — click the button to expand/collapse the chat interface*
+
+---
+
+### 🔀 Dual-Mode Interface
+
+| Workflow Mode | Ask Mode |
+|:---:|:---:|
+| ![Workflow Mode](./docs/assets/ArtifactLayout.png) | ![Ask Mode](./docs/assets/AskMozaiks.png) |
+| *Chat + Artifact split view* | *Full chat with history sidebar* |
+
+</div>
+---
+
+## 📚 Documentation
+
+- [Architecture Overview](ARCHITECTURE.md) — System design and component model
+- [Getting Started](docs/getting-started.md) — Full setup guide
+- [Releasing](docs/releasing.md) — Tag-driven release and PyPI publish flow
+- [Mid-Flight Journeys](docs/reference/deep-dives/mid-flight-journeys.md) — Flagship orchestration capability and runtime semantics
+- [Workflow Authoring Contracts](docs/architecture/foundations/workflow-authoring-contracts.md) — Canonical strict YAML contract
+- [Contributing](CONTRIBUTING.md) — Development workflow
+
+Build the docs locally with `pip install -r requirements-docs.txt` and `./scripts/build-docs.ps1`.
+
+---
+
+## Contributing
+
+See `CONTRIBUTING.md`.
+
+## License
+
+MIT. See `LICENSE`.

mozaiks-0.1.0/README.md

@@ -0,0 +1,102 @@
+# Mozaiks
+
+<div align="center">
+
+<img src="./docs/assets/mozaik_logo.svg" alt="Mozaiks Logo" width="180"/>
+
+[![Release](https://img.shields.io/github/v/release/BlocUnited-LLC/mozaiks)](https://github.com/BlocUnited-LLC/mozaiks/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11+-blue?logo=python)](https://www.python.org/)
+[![AG2](https://img.shields.io/badge/AG2-Autogen-green)](https://github.com/ag2ai/ag2)
+
+</div>
+
+## 🎯 What is MozaiksAI?
+Declarative orchestration runtime and Studio-driven app framework for AG2 (formerly Microsoft Autogen):
+
+- ✅ **Event-Driven Architecture** — Runtime, app, workflow, UI, and hosted events stay separated by contract
+- ✅ **Mid-Flight Journeys (MFJ)** — Run parallel workflows by fork/join with deterministic parent resume
+- ✅ **Real-Time WebSocket Transport** — Live agent streaming to React frontends
+- ✅ **Dynamic UI Integration** — Agents can invoke React components during workflows
+- ✅ **Multi-Tenant Isolation** — App-scoped data and execution contexts
+- ✅ **Declarative Workflows** — YAML manifests, no code changes needed
+- ✅ **Comprehensive Observability** — Built-in metrics, logging, and token tracking
+- ✅ **Persistent State Management** — Resume conversations exactly where they left off
+
+Current recommended setup: clone the repo, create a virtual environment, run
+the builder bootstrap script, and let it open Studio for you.
+
+Builder path:
+
+```powershell
+git clone https://github.com/BlocUnited-LLC/mozaiks.git
+cd mozaiks
+.\scripts\bootstrap-builder.ps1 -Workspace .\my-first-mozaiks-app
+```
+
+Advanced/framework path:
+
+- `mozaiks onboard --full`
+- `mozaiks studio --open`
+- `mozaiks init`
+- `mozaiks serve`
+
+Manual equivalent of the bootstrap path:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+pip install -e .
+mozaiks quickstart --dir ./my-first-mozaiks-app
+```
+
+Current repo layout:
+
+- `web_shell/` - local Vite shell host source
+- `factory_app/app/` - shared Studio app bundle and default brand assets
+- `factory_app/workflows/` - shared builder workflow root
+
+---
+
+## 🎨 See It In Action
+
+<div align="center">
+
+### 💬 Embeddable Floating Widget
+
+![Widget Demo](./docs/assets/widgetAction.gif)
+
+*Drop a floating assistant anywhere in your app — click the button to expand/collapse the chat interface*
+
+---
+
+### 🔀 Dual-Mode Interface
+
+| Workflow Mode | Ask Mode |
+|:---:|:---:|
+| ![Workflow Mode](./docs/assets/ArtifactLayout.png) | ![Ask Mode](./docs/assets/AskMozaiks.png) |
+| *Chat + Artifact split view* | *Full chat with history sidebar* |
+
+</div>
+---
+
+## 📚 Documentation
+
+- [Architecture Overview](ARCHITECTURE.md) — System design and component model
+- [Getting Started](docs/getting-started.md) — Full setup guide
+- [Releasing](docs/releasing.md) — Tag-driven release and PyPI publish flow
+- [Mid-Flight Journeys](docs/reference/deep-dives/mid-flight-journeys.md) — Flagship orchestration capability and runtime semantics
+- [Workflow Authoring Contracts](docs/architecture/foundations/workflow-authoring-contracts.md) — Canonical strict YAML contract
+- [Contributing](CONTRIBUTING.md) — Development workflow
+
+Build the docs locally with `pip install -r requirements-docs.txt` and `./scripts/build-docs.ps1`.
+
+---
+
+## Contributing
+
+See `CONTRIBUTING.md`.
+
+## License
+
+MIT. See `LICENSE`.

mozaiks-0.1.0/chat-ui/README.md

@@ -0,0 +1,141 @@
+# @mozaiks/chat-ui
+
+The single frontend package for the mozaiks stack — UI primitives, state machine, pages, theming, event dispatch, and technical adapters (API/auth).
+
+## Structure
+
+```
+src/
+├── components/        Chat components (ChatInterface, ArtifactPanel, FluidChatLayout), layout, actions
+├── core/              Event dispatching, dynamic UI handler, action utilities, WorkflowUIRouter
+├── pages/             ChatPage, MyWorkflowsPage
+├── adapters/          API and auth adapter contracts
+├── providers/         Config-driven BrandingProvider, NavigationProvider
+├── primitives/        Core artifact renderers
+├── state/             uiSurfaceReducer (surface FSM)
+├── styles/            Theme system, design tokens
+├── context/           ChatUIProvider + useChatUI hook
+├── hooks/             useWidgetMode
+├── widget/            GlobalChatWidgetWrapper
+├── config/            Environment config, workflow discovery
+├── registry/          Generic component registry
+├── navigation/        Navigation cache and action hooks
+├── services/          Service initialization
+├── @chat-workflows/   Alias entry point (see Workflow UI section below)
+├── workflows_stub/    No-op stub used when no real workflows are registered
+└── main.jsx           Minimal dev demo (mock adapters)
+
+template/
+├── App.jsx            Starter app shell using ChatUIProvider + providers
+├── adapters/          Mock API adapter for local dev without backend
+├── workflows/         Example workflow modules (hello_world)
+└── brands/public/     Declarative branding config + assets (brand.json)
+```
+
+## Workflow UI Components (`@chat-workflows` alias)
+
+chat-ui keeps workflow UI registration inside its own package, but the actual workflow root is still a **host-owned injection seam**.
+
+The registry module reads `<workflow>/ui/index.js` barrels from a build-time alias named `@chat-workflows-root`.
+That keeps chat-ui decoupled from repo layout and artifact paths while letting the host inject one selected workflow root for the active host/session.
+
+### How it works
+
+1. **In chat-ui (this package):** the internal registry module scans `@chat-workflows-root/*/ui/index.{js,jsx}`.
+2. **In a consuming app:** the bundler alias `@chat-workflows-root` is configured to point at the selected workflow root for that host/session.
+3. **In standalone/embed builds:** `@chat-workflows-root` points at an empty stub directory, so no workflow UI is registered.
+
+### Consuming app setup (Vite example)
+
+The consuming app must configure its bundler to resolve the injected workflow root:
+
+```js
+// vite.config.js
+import { defineConfig } from 'vite';
+import path from 'path';
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      '@chat-workflows-root': path.resolve(__dirname, '../factory_app/workflows'),
+    },
+  },
+});
+```
+
+For Studio in this repo, that selected root is `factory_app/workflows`. For an app/product host, it is usually the active app root's `workflows/` directory.
+
+### Creating a workflow UI module
+
+Use the template pattern:
+
+```text
+template/workflows/
+├── index.js
+└── my_workflow/
+    ├── index.js
+    └── MyWorkflowArtifact.jsx
+```
+
+- `my_workflow/index.js` exports `{ name, label, artifactComponent, suggestions }`.
+- `name` must match backend `orchestrator.yaml`.
+- Register each module in `template/workflows/index.js`.
+- `artifactComponent` receives `{ data, status, onAction }`.
+
+## Canonical Paths
+
+- `src/state/uiSurfaceReducer.js` — `ask/workflow/view` surface FSM
+- `src/components/chat/FluidChatLayout.jsx` — adaptive layout
+- `src/context/ChatUIContext.jsx` — provider + hook
+- `src/pages/ChatPage.js` — full chat page composition
+
+## Import Surfaces
+
+Use the package entrypoint that matches the host you are building.
+
+- `@mozaiks/chat-ui` — full web entrypoint; exports browser UI, pages, routing helpers, browser auth adapters, and app shell components.
+- `@mozaiks/chat-ui/core` — portable shared-core entrypoint; exports transport, state, adapters, providers, and hooks intended for non-browser hosts such as React Native.
+- `@mozaiks/chat-ui/platform` — platform bridge; lets a non-browser host inject synchronous storage, auth token lookup, runtime config overrides, and base URLs.
+
+These paths are declared explicitly in `package.json` via the package `exports` map. The portable surface is now formalized there rather than relying on extra top-level re-export files.
+
+### React Native / non-browser hosts
+
+Import the portable core surface and configure the platform bridge before mounting the provider.
+
+```js
+import { configurePlatform } from '@mozaiks/chat-ui/platform';
+import { ChatUIProvider, useChatUI, useConversation } from '@mozaiks/chat-ui/core';
+
+configurePlatform({
+  storage: {
+    getItem: (key) => mmkv.getString(key) ?? null,
+    setItem: (key, value) => mmkv.set(key, value),
+    removeItem: (key) => mmkv.delete(key),
+  },
+  auth: {
+    getAccessToken: () => tokenStore.currentToken ?? null,
+  },
+  getBaseUrls: () => ({
+    httpUrl: 'https://api.example.com',
+    wsUrl: 'wss://api.example.com',
+  }),
+});
+```
+
+Use a synchronous store for `storage`. `AsyncStorage` is not suitable for the current shared core because some reads happen synchronously during initialization.
+
+Web-only auth adapters (e.g. `mockAuthAdapter`) should not be imported from a native host. Auth is host-injected via the `authAdapter` prop.
+
+## Dev Demo
+
+```bash
+npm run dev
+```
+
+Starts a lightweight app with mock auth/API adapters for testing without a full platform.
+
+## Frontend Build Guide
+
+See `/docs/guides/CREATE_FRONTEND_WITH_MOZAIKS.md` for step-by-step frontend setup and declarative `brand.json` customization.
+

mozaiks-0.1.0/chat-ui/__init__.py

@@ -0,0 +1 @@
+"""Packaged chat-ui source bundle for Studio/frontend resource resolution."""