MIOSA
Technical working brief · July 21, 2026

Commas + MIOSA
Agent Infrastructure Pilot

A structured proposal for integrating governed agents, organization-scoped context, configurable models, customer-owned keys, and short-lived sandboxes into the Commas product experience.

Status Working proposalAudience Product, engineering, security, leadershipDecision Technical discovery before scope
Commas seller workspace
Commas dashboard product interface
CommasMIOSA orchestrationIsolated run
How to use this brief

Three actions. In this order.

Role-based review path

Each owner can go directly to the decisions they need.

The full document remains shared. These paths reduce review time before the next session.

Open miosa.ai/docs
01
Executive summary

What the meeting established

The opportunity is not a generic chatbot. It is a governed execution layer behind the product experience Commas already owns.

Activation means first dollar

The strongest small-business journey removes setup friction and gets a seller to a real, reviewable, monetizable asset.

Isolation is a product primitive

The team identified per-user, short-lived environments as the missing foundation for safe agent execution and cleanup.

The same runtime can serve two markets

Small-business users need a guided path. Enterprise teams need policy, integrations, control, and deployment choice.

NowValidate one narrow journey

Do not start by rebuilding the entire agent stack.

NextMeasure the controlled pilot

Quality, speed, reliability, cost, and adoption.

ThenChoose the scale architecture

Managed, Commas-controlled cloud, or hybrid.

02
Product lanes

One foundation, two deliberately different experiences

The interface and level of control change by customer. The core isolation, orchestration, and evidence model remains consistent.

Small business

Guided path to first dollar

A constrained agent asks only what is needed, creates the commercial journey, and returns a preview for approval.

  1. 01Describe the offer and buyer
  2. 02Generate funnel and checkout assets
  3. 03Review a live preview
  4. 04Publish through Commas
Pilot this lane first
Enterprise

Embedded operating layer

Teams configure agents, data access, policies, providers, and deployment boundaries without leaving the Commas product.

  1. 01Connect approved systems and data
  2. 02Assign organization and workspace scope
  3. 03Run agents under explicit policy
  4. 04Audit decisions and actions
Design after pilot evidence
03
SDK and codebase integration

The next conversation starts with the actual Commas stack

MIOSA supports language-specific integration clients and can add adapters where needed. The first technical task is mapping the real codebase, not guessing from a demo.

SDK integration flow from Commas product to MIOSA and isolated runtime
01

Inspect the Commas codebase

Identify backend language, deployment model, authentication boundary, API clients, and the current funnel agent implementation.

02

Install the appropriate SDK client

Use the supported client for the Commas backend. Add a custom adapter only where the existing application boundary requires one.

03

Map identity and tenancy

Translate Commas customers, teams, users, and projects into explicit organization and workspace scopes before any agent receives context.

04

Define the agent contract

Set instructions, tools, source access, output schema, model parameters, budgets, review rules, and publishing permissions.

05

Broker secrets and launch isolation

Pass approved credentials through a secret boundary. Create a short-lived sandbox with explicit image, network, time, and resource policies.

06

Review, publish, and close

Return a preview to Commas, require the configured approval, write through Commas APIs, retain evidence, and destroy temporary runtime state.

Illustrative server-side request
const run = await miosa.runs.create({
  organization: commasCustomerId,
  workspace: sellerWorkspaceId,
  agent: "first-dollar-builder",
  input: sellerIntent,
  review: "required"
});

Exact syntax and language are confirmed against the current SDK and Commas backend during discovery.

04
Tenancy, context, and isolation

Persistent business context and temporary compute are different things

A workspace is the governed context boundary. A sandbox is the temporary execution environment created for a run. Confusing them creates data leakage and lifecycle ambiguity.

Hierarchy of Commas tenant, customer organization, workspace, agent run, and short-lived sandbox
Organization

Ownership and policy boundary for a Commas customer, business, or enterprise account.

Workspace

Scoped context for a seller, team, product journey, client, or project.

Agent

Configured role with instructions, tools, context access, model policy, and output contract.

Run

One governed request with an identity, state, trace, cost, result, and review status.

Sandbox

Temporary compute, filesystem, process, and network boundary used by the run.

Evidence

Durable record of what ran, what it accessed, what it returned, and whether cleanup succeeded.

Lifecycle for a governed agent run
05
Configurable agent layer

Commas controls the experience. Each journey controls its agent configuration.

The pilot should expose the minimum configuration needed by the team while keeping secrets, infrastructure controls, and provider access behind appropriate boundaries.

ControlExamplesScope
Agent identityName, purpose, instructions, ownerProduct journey or workspace
ContextApproved sources, memory, user inputsOrganization and workspace
ToolsCommas APIs, providers, internal servicesAllowlist per agent
ModelProvider, model, temperature, limitsAgent or task type
CredentialsCommas-owned or customer-owned keysSecret broker, never prompt text
ExecutionImage, CPU, memory, time, egressRun and sandbox policy
OutputSchema, preview, approval, write targetProduct action
EvidenceTrace, cost, result, cleanup statusRetained execution record
Commas and MIOSA reference architecture
Security claims require joint validation.

The pilot must produce a reviewed threat model, ownership matrix, data flow, retention policy, and testable acceptance criteria before production.

06
Pilot and consulting engagement

Start with 3-5 selected users and one measurable journey

Roberto works directly with product and engineering to map the codebase, configure the integration, instrument the pilot, and transfer the operating model.

Phase 1

Technical discovery

Codebase, SDK, agent code, identity, APIs, data, security, deployment, baseline.

Output: decision record
Phase 2

Controlled pilot

One first-dollar journey, 3-5 users, isolated runs, review, metrics, support.

Output: measured integration
Phase 3

Scale decision

Assess quality, economics, reliability, placement, ownership, and enterprise path.

Output: go, revise, or stop

Codebase and SDK mapping

Select the integration boundary and implement required adapters.

Tenancy design

Map users, teams, organizations, workspaces, agents, and data access.

Agent configuration

Instructions, tools, models, parameters, keys, budgets, and outputs.

Controls and transfer

Isolation tests, instrumentation, documentation, and team enablement.

ActivationSelected user reaches a live, reviewable asset
TimeMinutes from intent capture to usable preview
QualityHuman changes required before publishing
ReliabilityCompletion, retry, failure, and cleanup rates
EconomicsModel and compute cost per completed journey
AdoptionUsers who complete the journey without intervention
Commas and MIOSA pilot responsibility map
07
Proposed Monday, July 27

Technical discovery and pilot selection

Reply to the existing email thread, confirm the time, and include the product and engineering owners who can answer implementation questions.

10 minChoose the first-dollar journey

User, starting state, publish event, and successful result.

15 minInspect the current code and SDK boundary

Backend language, agent code, APIs, test tenant, and shared sandbox.

15 minMap identity, data, and isolation

Organizations, workspaces, credentials, network, retention, audit, cleanup.

10 minSelect pilot placement

MIOSA managed, Commas-controlled cloud, or a limited hybrid.

10 minLock owners and acceptance criteria

Scope, success metrics, exclusions, timeline, and next commercial step.

This is a non-binding working proposal for technical discovery. Exact scope, controls, guarantees, ownership, timeline, and commercial terms require joint validation.