feat(project): add project-aware invoke

README.md

@@ -104,6 +104,17 @@ agentcore                          # interactive TUI
 │       ├── get                    # get an evaluator by id (type-agnostic)
 │       ├── list                   # list evaluators (server-side paginated)
 │       └── delete                 # delete an evaluator by id
+├── project                        # manage an AgentCore project
+│   ├── create                     # create a project
+│   ├── add                        # add project resources
+│   ├── remove                     # remove project resources
+│   ├── dev                        # run the project locally
+│   ├── deploy                     # deploy the project
+│   ├── invoke                     # invoke a deployed project resource
+│   │   ├── runtime                # use the existing Runtime invoke experience
+│   │   └── harness                # use the existing Harness invoke experience
+│   ├── status                     # inspect deployed project resources
+│   └── build                      # synthesize deployable artifacts
 └── config                         # read/write global config values
 ```
 
@@ -116,6 +127,26 @@ Global flags (declared at the root, available on every command):
 | `--debug`        | Debug logging.                                                       |
 | `--endpoint-url` | Override the service endpoint URL (e.g. for testing against a stub). |
 
+### Invoke a project resource
+
+Run `agentcore project invoke` from inside a project to choose a deployed
+Runtime or Harness interactively. Headless invocation keeps each resource's
+existing input contract:
+
+```bash
+agentcore project invoke runtime \
+  --name checkout \
+  --payload '{"prompt":"Check order 123."}' \
+  --content-type application/json
+
+agentcore project invoke harness \
+  --name support \
+  --prompt "Help with my account."
+```
+
+Use `--target` to select a deployment target. When a project declares exactly
+one resource of the requested type, `--name` may be omitted.
+
 ### Examples
 
 ```bash

src/assets/templates/hello-world-python-container/README.md

@@ -25,3 +25,9 @@ Environment variables for local development go in `agentcore/.env.local`
 ```bash
 agentcore project deploy
 ```
+
+Invoke the deployed Runtime with its native payload:
+
+```bash
+agentcore project invoke runtime --payload '{"prompt":"Hello!"}'
+```

src/assets/templates/hello-world-python/README.md

@@ -27,9 +27,6 @@ curl -X POST http://localhost:8080/invocations \
   -d '{"prompt": "Hello!"}'
 ```
 
-<!-- TODO: replace the uv run + curl instructions with `agentcore dev` and
-     `agentcore invoke` once those commands are available. -->
-
 ## Build your agent
 
 Start in `main.py`:
@@ -58,3 +55,8 @@ for multi-agent patterns, MCP tools, and model configuration.
 
 Deploy from the project root with the AgentCore CLI; the CDK app under
 `agentcore/cdk` provisions the Runtime that hosts this agent.
+
+```bash
+agentcore project deploy
+agentcore project invoke runtime --payload '{"prompt":"Hello!"}'
+```

src/assets/templates/strands-http-python/README.md

@@ -38,3 +38,9 @@ Command Prompt, or `.\.venv\Scripts\activate.ps1` in Windows PowerShell.
 # Deployment
 
 After providing credentials, `agentcore project deploy` will deploy your project into Amazon Bedrock AgentCore.
+
+Invoke the deployed Runtime with its native payload:
+
+```bash
+agentcore project invoke runtime --payload '{"prompt":"Hello!"}'
+```

src/components/Root.tsx

@@ -107,6 +107,7 @@ import { GatewayRuleScreen } from "../handlers/gateway/rule/screen.tsx";
 import { GatewayRuleListScreen } from "../handlers/gateway/rule/list/screen.tsx";
 import { GatewayRuleGetScreen } from "../handlers/gateway/rule/get/screen.tsx";
 import { GatewayInvokeScreen } from "../handlers/gateway/invoke/screen.tsx";
+import { ProjectInvokePickerScreen } from "../handlers/project/invoke/screen.tsx";
 import { RootScreen, HelpScreen } from "../handlers/screen.tsx";
 import type { Context } from "../router";
 
@@ -140,6 +141,10 @@ export function Root({ path, ctx, core, queryClient }: RootProps) {
       <MemoryRouter initialEntries={[path]}>
         <Routes>
           <Route path="agentcore" element={<RootScreen ctx={ctx} core={core} />} />
+          <Route
+            path="agentcore/project/invoke"
+            element={<ProjectInvokePickerScreen ctx={ctx} core={core} />}
+          />
           <Route path="agentcore/harness" element={<HarnessScreen ctx={ctx} core={core} />} />
           {/* Bare `get` (no id) has nothing to show — send the user to the list. */}
           <Route

src/core/project/backends/cdk.test.ts

@@ -3,11 +3,13 @@ import { existsSync } from "node:fs";
 import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { tmpdir } from "node:os";
+import type { Stack } from "@aws-sdk/client-cloudformation";
 import type { DeployResult, Project, ProjectEvent } from "../../../handlers/project/types";
+import { FsReadWriteJson } from "../../../io";
 import { ProjectSpecSchema } from "../../../projectSchemas/project";
 import { createSilentLogger } from "../../../testing";
 import { CdkBackend } from "./cdk";
-import { DEPLOYED_STATE_RELATIVE_PATH } from "./cdk/deployedState";
+import { DEPLOYED_STATE_RELATIVE_PATH, updateTargetState } from "./cdk/deployedState";
 import type { DeployBackendInput } from "./types";
 import type { BootstrapState } from "./cdk/environment";
 import type { CdkCredentialProvider, CdkOperation, CdkOutputs, CdkRunOptions } from "./cdk/toolkit";
@@ -17,6 +19,9 @@ const TARGET = {
   account: "111122223333",
   region: "us-east-1",
 } as const;
+const STACK_ARN =
+  "arn:aws:cloudformation:us-east-1:111122223333:stack/AgentCore-example-default/abc";
+const json = new FsReadWriteJson({ logger: createSilentLogger() });
 
 /** A template holding only what CDK adds itself, as an empty project synthesizes. */
 const METADATA_ONLY = { CDKMetadata: { Type: "AWS::CDK::Metadata" } };
@@ -122,6 +127,7 @@ type HarnessOptions = {
   bootstrapError?: Error;
   /** Whether CloudFormation still holds the target's stack. Defaults to present. */
   stackExists?: boolean;
+  stack?: Stack;
 };
 
 function harness(options: HarnessOptions = {}) {
@@ -133,6 +139,8 @@ function harness(options: HarnessOptions = {}) {
   const accountRegions: string[] = [];
   const bootstrapRegions: string[] = [];
   const stackProbes: string[] = [];
+  const stackReads: { stackName: string; region: string; credentials: CdkCredentialProvider }[] =
+    [];
   let templateLoads = 0;
   let templateCleanups = 0;
   const credentials: CdkCredentialProvider = async () => ({
@@ -194,6 +202,10 @@ function harness(options: HarnessOptions = {}) {
         },
       };
     },
+    describeStack: async (region, provider, stackName) => {
+      stackReads.push({ stackName, region, credentials: provider });
+      return options.stack;
+    },
   });
 
   return {
@@ -207,6 +219,7 @@ function harness(options: HarnessOptions = {}) {
     credentials,
     runs,
     stackProbes,
+    stackReads,
     templateLoads: () => templateLoads,
     templateCleanups: () => templateCleanups,
   };
@@ -563,3 +576,121 @@ describe("CdkBackend.deploy", () => {
     expect(subject.runs.map(({ operation }) => operation.kind)).toEqual(["bootstrap"]);
   });
 });
+
+describe("CdkBackend.resolveDeployedResource", () => {
+  test.each([
+    {
+      resourceType: "runtime" as const,
+      name: "checkout_agent",
+      exportName: "AgentCore-example-default-checkout-agent-RuntimeId",
+      id: "checkout_agent-AbCdEf1234",
+    },
+    {
+      resourceType: "harness" as const,
+      name: "support_agent",
+      exportName: "AgentCore-example-default-Harness-support-agent-Id",
+      id: "support_agent-AbCdEf1234",
+    },
+  ])(
+    "reads deployed state and resolves a $resourceType ID from its live stack",
+    async (example) => {
+      const input = await project();
+      await updateTargetState(json, input.rootPath, TARGET.name, { stackArn: STACK_ARN });
+      const subject = harness({
+        stack: {
+          StackName: "AgentCore-example-default",
+          CreationTime: new Date(0),
+          StackStatus: "CREATE_COMPLETE",
+          Outputs: [
+            {
+              ExportName: example.exportName,
+              OutputValue: example.id,
+            },
+          ],
+        },
+      });
+
+      const id = await subject.backend.resolveDeployedResource(input, {
+        target: TARGET,
+        resourceType: example.resourceType,
+        name: example.name,
+      });
+
+      expect(id).toBe(example.id);
+      expect(subject.stackReads).toEqual([
+        {
+          stackName: STACK_ARN,
+          region: TARGET.region,
+          credentials: subject.credentials,
+        },
+      ]);
+      expect(subject.accountCredentials).toEqual([subject.credentials]);
+    },
+  );
+
+  test("fails without reading AWS when the target has no deployed stack ARN", async () => {
+    const input = await project();
+    const subject = harness();
+
+    await expect(
+      subject.backend.resolveDeployedResource(input, {
+        target: TARGET,
+        resourceType: "harness",
+        name: "support",
+      }),
+    ).rejects.toThrow(/not deployed.*project deploy --target default/s);
+    expect(subject.stackReads).toEqual([]);
+    expect(subject.accountCredentials).toEqual([]);
+  });
+
+  test("fails actionably when the recorded stack no longer exists", async () => {
+    const input = await project();
+    await updateTargetState(json, input.rootPath, TARGET.name, { stackArn: STACK_ARN });
+    const subject = harness();
+
+    await expect(
+      subject.backend.resolveDeployedResource(input, {
+        target: TARGET,
+        resourceType: "harness",
+        name: "support",
+      }),
+    ).rejects.toThrow(/not deployed.*project deploy --target default/s);
+    expect(subject.stackReads[0]?.stackName).toBe(STACK_ARN);
+  });
+
+  test("fails when the live stack has no output for the selected resource", async () => {
+    const input = await project();
+    await updateTargetState(json, input.rootPath, TARGET.name, { stackArn: STACK_ARN });
+    const subject = harness({
+      stack: {
+        StackName: "AgentCore-example-default",
+        CreationTime: new Date(0),
+        StackStatus: "CREATE_COMPLETE",
+        Outputs: [],
+      },
+    });
+
+    await expect(
+      subject.backend.resolveDeployedResource(input, {
+        target: TARGET,
+        resourceType: "runtime",
+        name: "checkout",
+      }),
+    ).rejects.toThrow(/Runtime 'checkout'.*not deployed.*default/s);
+  });
+
+  test("rejects the wrong account before reading CloudFormation", async () => {
+    const input = await project();
+    await updateTargetState(json, input.rootPath, TARGET.name, { stackArn: STACK_ARN });
+    const subject = harness({ account: "999900001111" });
+
+    await expect(
+      subject.backend.resolveDeployedResource(input, {
+        target: TARGET,
+        resourceType: "runtime",
+        name: "checkout",
+      }),
+    ).rejects.toThrow(/expects AWS account 111122223333.*999900001111/s);
+    expect(subject.stackReads).toEqual([]);
+  });
+});