Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Bug]: Sample Agent hangs before invoking ChatApp searchContacts on Android 17

Open
  • Is something wrong?
#39 2 comments 0 reactions 1 assignee View on GitHub

@manoj897 is already working on this.

Since Jul 27, 2026.

Assessment

This issue has not been assessed yet.

Description

bug question
Is there an existing issue for this?
  • I have searched the existing issues
Is there a StackOverflow question about this issue?
  • I have searched StackOverflow
What happened?
What happened?

Using the Agent and ChatApp samples built unchanged from main at commit d9cdc55, the Agent correctly selects ChatApp's searchContacts AppFunction for a natural-language request, but execution never reaches ChatApp. The Agent remains on the in-progress spinner and does not return a result.

Prompt:

Find contacts named Bob in ChatApp.

Expected: ChatApp's searchContacts function executes and returns matching contacts.

Actual: The LLM selects the correct tool and parameters, metadata lookup succeeds, then AppFunctionManager.executeAppFunction() does not complete. ChatApp's generated AppFunction service is not entered.

Reproduction
  1. Checkout android/appfunctions at d9cdc55 on main.
  2. Build ChatApp with ./gradlew :app:assembleDebug.
  3. Build the Agent with ./gradlew :app:assembleStandardDebug.
  4. Uninstall both packages, then install both APKs:
    com.example.chatapp and com.example.appfunctions.agent.
  5. Launch the Agent with shell identity instrumentation:
    adb shell am instrument -w com.example.appfunctions.agent/.ShellIdentityInstrumentation
  6. Configure a valid Gemini API key.
  7. Submit: Find contacts named Bob in ChatApp.
  8. Observe that the Agent stays in progress indefinitely.
Control test

The same installed ChatApp function succeeds immediately when invoked directly:

adb shell "cmd app_function execute-app-function \  --package com.example.chatapp \  --function 'com.example.chatapp.appfunctions.BaseChatAppFunctionService#searchContacts' \  --parameters '{"query": "Bob", "filterType": "INDIVIDUAL"}'"

This returned two Bob contacts in 0.927 seconds, confirming that the function is installed, indexed, enabled, and executable.

Localization

Temporary diagnostics were kept on a separate branch and were not part of the clean reproduction. They show:

  • Gemini returned a tool call for ChatApp searchContacts.
  • Function parameters were converted successfully.
  • searchAppFunctions returned one matching function in 34 ms.
  • The Agent entered AppFunctionManager.executeAppFunction().
  • No receiver-entry event was observed in ChatApp.
  • The client call did not complete within a diagnostic 20-second timeout.

This localizes the failure after LLM tool selection and metadata discovery, but before ChatApp's AppFunction service receives the request.

Environment
  • Device: Pixel 10 Pro Fold
  • Android: 17 / API 37
  • Repository commit: d9cdc55

No SecurityException was observed. On API 37, the Agent constructs the request with AppInteractionAttribution.

Is there a known API 37 dispatch or attribution issue that can cause an AndroidX client invocation to wait before the target service is entered? Are additional permissions or platform configuration required beyond the supplied ShellIdentityInstrumentation flow?

Relevant logcat output
Temporary diagnostic trace (isolated branch; clean main reproduces the same spinner):

I/AppFunctionTrace: LLM_TOOL_SELECTED package=com.example.chatapp function=com.example.chatapp.appfunctions.BaseChatAppFunctionService#searchContacts
I/AppFunctionTrace: PARAMETERS_CONVERTED keys=[filterType, query]
I/AppFunctionTrace: METADATA_LOOKUP_SUCCESS count=1 elapsedMs=34
I/AppFunctionTrace: CLIENT_DISPATCH_START package=com.example.chatapp function=com.example.chatapp.appfunctions.BaseChatAppFunctionService#searchContacts
E/AppFunctionTrace: CLIENT_DISPATCH_EXCEPTION elapsedMs=20000
java.lang.IllegalStateException: AppFunction execution timed out

No ChatApp receiver-entry trace was emitted for the Agent invocation.

Direct shell control on the same clean installation:

{
  "androidAppfunctionsReturnValue": [
    {
      "endpointType": ["INDIVIDUAL"],
      "endpointValue": ["2"],
      "displayName": ["Bob Johnson"]
    },
    {
      "endpointType": ["INDIVIDUAL"],
      "endpointValue": ["7"],
      "displayName": ["Bob Johnson"]
    }
  ]
}
Code of Conduct
  • I agree to follow this project's Code of Conduct
Dominant language
Kotlin
Stars
210
Forks
45
Avg merge
12h 24m
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from android/appfunctions

All issues in android/appfunctions

Similar issues

More Kotlin issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.