⚠️ Pre-release (0.1.x) — Highly experimental. APIs may change without notice. Not for production. Details.

intentcall_core

Transport-agnostic agent intent registry and runtime for Flutter MCP Toolkit.

Authoring

Authors define descriptors + executors; they do not implement a public AgentIntent interface. The registry stores RegisteredAgentIntent (descriptor + execute).

Invoke path

MCP CallToolRequest → AgentRegistry.invoke → AgentResult → CallToolResult

The Flutter MCP server uses McpHost, which owns an AgentRuntime with McpPublishAdapter as the sole MCP attach path: registry registration drives MCP publish via IntentRegistered events, and runtime.stop() on host dispose.

MCP publish lives in intentcall_mcp (McpPublishAdapter). WebMCP and Gemma use parallel adapters on the same registry:

final runtime = AgentRuntime(
  registry: InMemoryAgentRegistry(),
  adapters: [
    McpPublishAdapter(publish: ..., unpublish: ...),
    WebMcpPublishAdapter(publish: ..., unpublish: ...),
    GemmaPublishAdapter(register: ..., unregister: ...),
  ],
);
await runtime.start();

Client helpers

• AgentResult.envelope / resourceEnvelope (intentcall_schema)
• AgentWireArgs for string-key maps
• AgentClientInstall.once in mcp_toolkit for lazy registration

Migration helpers

The main intentcall_core.dart barrel is the runtime/authoring API. The legacy MCPCallEntry migration helpers are intentionally exposed through a separate library so downstream packages can depend on them explicitly:

import 'package:intentcall_core/intentcall_core_migration.dart';

Use this import for MigrateAgentEntriesMigrator, MigrateAgentEntriesReport, MigrateAgentEntriesPathNotFound, and migrateAgentEntriesAtPath.

Related packages

• intentcall_schema — results, validation, wire args
• intentcall_mcp — MCP bridge, publish adapter, resource mapper
• intentcall_webmcp — WebMCP modelContext publish adapter
• intentcall_gemma — on-device Gemma function-calling adapter
• intentcall_apple / intentcall_android — agent_manifest.json codegen
• intentcall_testing — registry contract helpers

Design spec (in parent repo): intentcall design.