marona 0.1.0

Official Dart client SDK for Marona-compatible AI runtimes.

marona

Official Dart client SDK for Marona-compatible AI runtimes.

Marona provides a simple interface for messaging, discovering apps, managing permissions, connecting service accounts, receiving inbound events, and using tools from any compatible runtime.

Use it with Marona Cloud or with your own self-hosted Marona-compatible runtime.

Install

dependencies:
  marona: ^0.1.0

Send a message

import 'package:marona/marona.dart';

final client = Marona(
  'https://edge.marona.ai',
  apiKey: 'mrn_live_...',
);

final response = await client.message(
  'Create a PowerPoint about AI introduction',
  interfaceName: 'mobile_app',
  conversationId: 'demo',
);

print(response.reply);

Runtime targets

Marona Cloud:

final client = Marona(
  'https://edge.marona.ai',
  apiKey: 'mrn_live_...',
);

Self-hosted:

final client = Marona(
  'https://my-company-edge.example.com',
  apiKey: 'mrn_live_...',
);

Pair an interface with WhatsApp

final pairing = await client.startPairing(
  interfaceName: 'web',
  deviceName: 'My web app',
);

print(pairing.displayCode);
print(pairing.whatsappUrl);

After the user sends the pairing code from WhatsApp, poll for completion:

final status = await client.pairingStatus(pairing.pairingId);
final identityToken = status.identity?.accessToken;

Use the identity token on future requests:

final response = await client.message(
  'What is on my calendar today?',
  identityToken: identityToken,
);

Connect an app account

Some apps need a user service connection, such as Gmail, Google Calendar, or Google Slides.

final connection = await client.connectApp(
  'slides',
  provider: 'google',
  identityToken: identityToken,
  returnUrl: 'https://example.com/connected',
);

print(connection.authorizationUrl);

Open authorizationUrl in a browser so the user can authorize the provider.

Advanced

EdgeRuntimeClient is kept as a compatibility class for existing integrations. New integrations should import Marona.